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/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 
5 throws IOException{ 

out.writeByte (tag) ; 
out .writeChar (name_index) ; 



A16. CONSTANT_Double_info.java 

Convience class for representing CONSTANT_Double_info structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 



public CONSTANT_Double_info (double d) { 
tag - 6; 
bytes = d; 

> 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Double_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 6) 

throw new ClassFormatError () ; 

bytes = in.readDouble() ; 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException ( 

out .writeByte (tag) ; 

out.writeDouble (bytes) ; 

long 1 = Double .doubleToLongBits (bytes) ; 

) 

} 

A 17. CONSTANT_FieIdref_info.java 

Convience class for representing CONSTANT JPieldrefjnfo structures within ClassFiles. 

import j ava . lang . * ; 
import j ava . io . * ; 



/** The name and type index this field if referencing to. */ 
public int name_and_type_index; 

/** Convenience constructor. */ 

public CONSTftNT_Fieldref_inf o (int class_index, int name and_type_index) ( 
tag = 9; 
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;__index = class_index; 
_and_type_index = name_and_type_index; 



/** Used during input serialization by ClassFile only. 1 
CONSTANT_Fieldref_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag 1= 9) 

throw new ClassFormatError () ; 

class_index = in . readchar ( ) ; 

name_and_type_index = in . readChar ( ) ; 

} 

/** Used during output serialization by ClassFile only, 
void serialize (DataOutputStream out) 

throws IOException( 

out.writeByte (tag) ; 

out.writeChar (class_index) ; 

out .writeChar (name_and type_index) ; 

) 



A18. CONSTANT_Float_info.java 

Convience class for representing CONSTANT_Float_info structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Float subtype of a constant pool entry. */ 

public final class CONSTANT_Float_info extends cp_info{ 



public CONSTANT_Float_info (float f ) { 



» 

/** Used during input serialization by ClassFile only. J 
CONSTANT_Float_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 4) 

throw new ClassFormatError () ; 

bytes = in.readFloat() ; 

) 

/** Used during output serialization by ClassFile only, 
public void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte (4) ; 

out. writeFloat (bytes) ; 

} 



A 19. CONSTANT_Integer_info.java 

60 Convience class for representing CONSTANTJntegerjnfo structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 
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/** Integer subtype of a constant pool entry. */ 

public final class CONSTANT_Integer_inf o extends cp_info{ 

/** The actual value. */ 
public int bytes; 

public CONSTANT_Integer_info(int b) { 
tag = 3; 
bytes = b; 



/** Used during input serialization by ClassFile only. */ 
CONSTANT_Integer_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 3) 

throw new ClassFormatError ( ) ; 

bytes - in.readlntO ; 



/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 

throws IOException( 

out.writeByte(tag) ; 

out . writelnt (bytes ) ; 

J 



A20. CONSTANT_InterfaceMethodref_info.java 

Convience class for representing CONSTANT JnterfaceMethodrefjnfo structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** InterfaceMethodref subtype of a constant pool entry. 

*/ 

public final class CONSTANT_Xnterf aceMethodref_inf o extends cp_info( 

/** The index to the class that this field is referencing to. */ 
public int class_index; 

/** The name and type index this field if referencing to. */ 
public int name_and_type_index; 

public CONSTANT_InterfaceMethodref_info (int class_index, 

int name_and_type_index) { 

tag = 11; 

this.class_index = class_index; 

this.name_and type_index = name_and_type_index; 



/** Used during input serialization by ClassFile only. */ 
CONSTANT_InterfaceMethodref_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 11) 

throw new ClassFormatError () ; 

class_index = in . readChar () ; 

name_and_type_index = in . readChar ( ) ; 
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/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte (tag) ; 

out.writeChar (class_index) ; 

out . writeChar (name_and_type_index) ; 

) 

) 

A21. CONST ANT_Long_info.java 

Convience class for representing CONSTANT_Long_info structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Long subtype of a constant pool entry. */ 

public final class CONSTANT_Long_inf o extends cp_info( 

/** The actual value. */ 
public long bytes; 

public CONSTANT_Long_info (long b) { 
tag = 5; 
bytes ■ b; 

} 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Long_info (ClassFile cf, DatalnputStream in) 

throws IOException( 

super (cf, in); 

if (tag != 5) 

throw new ClassFormatError () ; 

bytes = in.readLongO ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte (tag) ; 

out .writeLong (bytes) ; 



A22. CONSTANT_Methodref_info.java 

Convience class for representing CONSTANT_Methodref_info structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Methodref subtype of a constant pool entry. 

public final class CONSTANT_Methodref_inf o extends cp_info{ 

/** The index to the class that this field is referencing to. */ 
public int class_index; 

/** The name and type index this field if referencing to. */ 
public int name_and__type_index; 
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public^CONSTANT.Methodref^fodnt class_index, int nan,e_and_ty P e_index> ( 

this.class_i.ndex = class_index; 
j this . name_and_type_index = name_and_type_index; 

/** Used during input serialization by ClassFile only */ 
CONS T ANT_Methodr e f_info (ClassFile cf, DatalnputStream in) 

throws lOExceptionf 

super (cf, in); 

if (tag != 10) 

throw new ClassFormatError () ; 

class_index = in . readChar () ; 

name_and_type_index = in . readChar () ; 



/** Used during output serialization by ClassFile only, 
void serialize (DataOutputStreara out) 

throws lOExceptionf 

out.writeByte (tag) ; 

out.writeChar (class_index) ; 

out . writeChar (name_and_type_index) ; 



} 



A23.CONSTANT_NameAndType_info.java 

Convince class for representing CONSTANT_NameAndType info structures within 
Classf-iles, 

import java.io.*; 
import java.lang.*; 

/** NameAndType subtype of a constant pool entry. 

public final class CONSTANT_NameAndType_info extends cp_info{ 

/** The index to the Utf8 that contains the name. V 
public int name_index; 

/** The index fo the Utf8 that constains the signature. */ 
public int descriptor_index; 

PUbl tag C f N 12 ANT - NameAndTyPe - inf ° (int name - index ' in t descriptor_index) ( 

this.name_index ■ name_index; 
^ this.descriptor_index = descriptor_index; 

/** Used during input serialization by ClassFile only */ 
CONSTANT_NameAndType_info (ClassFile cf, DatalnputStream in) 

throws lOExceptionf 

super (cf, in); 

if (tag != 12) 

throw new ClassFormatError () ; 

name_index = in . readChar () ; 
^ descriptor_index = in . readChar () ; 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws lOExceptionf 

out.writeByte (tag) ; 
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A24. CONSTANT_String_info.java 

Convience class for representing CONSTANT_String_info structures within ClassFiles. 

import java.lang.*; 
import java.io. *; 

/** String subtype of a constant pool entry. 
*/ 

public final class CONSTANT_String_inf o extends cp_info( 

/** The index to the actual value of the string. */ 
public int string_index; 

public CONSTANT_String_inf o (int value) { 
tag - 8; 

string index = value; 

} 

/** ONLY TO BE USED BY CLASS FILE! */ 

public CONSTANT_String_inf o (ClassPile cf, DatalnputStream in) 
throws IOException{ 
super (cf, in) ; 
if (tag != 8) 

throw new ClassFormatError ( ) ; 
string index » in . readChar () ; 

) 

/** Output serialization, ONLY TO BE USED BY CLASSFILE! */ 
public void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte (tag) ; 

out.writeChar (string_index) ; 

} 



A25. CONSTANT JtJtf8_info.java 

Convience class for representing CONSTANT_Utf8_info structures within ClassFiles. 

import j ava . io . * ; 
import java.lang.*; 

/** Utf8 subtype of a constant pool entry. 

* We internally represent the Utf8 info byte array 

* as a String. 
V 

public final class CONSTANTJJtf 8_info extends cp_info{ 
array. */ 



' This constructor should be used for the purpose 
of part creation. It does not set the parent 
ClassFile reference. 
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public CONSTANT_Utf8_info (String s) { 
tag = 1; 

length = s. length () ; 
bytes = s; 



/** Used during input serialization by ClassFile only */ 
public CONSTANT_Utf8_info (ClassFile cf, DatalnputStream in) 

throws IOException( 

super (cf, in); 

if (tag != 1) 

throw new Class FormatError () ; 

length = in. readchar () ; 

byte[] b = new byte [length] ; 

in. read (b, 0, length); 

// WARNING: String constructor is deprecated, 
bytes = new String (b, 0, length); 



/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 

throws IOExceptionf 

out .writeByte (tag) ; 

out. writeChar (length) ; 

// WARNING: Handling of String coversion here might be problematic, 
out. writeBytes (bytes) ; 



public String toString(){ 
return bytes; 



A26. ConstantVaIue_attribute.java 

Convience class for representing ConstantValue attribute structures within ClassFiles 

import java.lang.*; 
import java.io.*; 

/** Attribute that allows for initialization of static variables in 
*^ classes. This attribute will only reside in a field_info struct. 



public final class ConstantValue_attribute extends attribute info{ 
public int constantvalue_index; 

public ConstantValue_attribute (ClassFile cf, int ani, int al, int cvi) ( 
super (cf); 

attribute_name_index = ani; 
attribute_length = al; 
constantvalue_index = cvi; 



public ConstantValue_attribute (ClassFile cf, DatalnputStream in) 
throws IOException( 
super (cf, in); 

constantvalue_index » in.readChar () ; 
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public void serialize (DataOutputStream out) 
throws IOException{ 
attribute_length = 2; 
super . serialize (out) ; 
out.writeChar (constantvalue_index) ; 

) 



A27. cp_info.java 

Convience class for representing cp_info structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Represents the common interface of all constant pool parts 
* that all specific constant pool items must inherit from. 



/** The type tag that signifies what kind of constant pool 

* item it is */ 
public int tag; 



/** Default constructor. Simply does nothing. */ 
public cp_inf o ( ) ( ) 

/** Constructor simply takes in the ClassFile as a reference to 
* it's parent 
*/ 

public cp_info (ClassFile cf) () 

/** Used during input serialization by ClassFile only. */ 
cp_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

tag = in.readUnsignedByteO ; 



A28. Deprecated_attribute.java 

Convience class for representing Deprecated_attribute structures within ClassFiles. 

import java.lang.*; 
import j ava . io . * ; 

/** A fix attributed that can be located either in the ClassFile, 

* field_info or the method_info attribute. Mark deprecated to 

* indicate that the method, class or field has been superceded. 

*/ 

public final class Deprecated_attribute extends attribute_inf o{ 

public Deprecated_attribute (ClassFile cf, int ani, int al) ( 
super (cf) ; 

attribute_name_index = ani; 
attribute_length = al; 



/** Used during input serialization by ClassFile only. */ 
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Deprecated_attribute(ClassFile cf, DatalnputStream in) 
throws IOException{ 
super (cf, in); 



A29. Exceptions_attribute.java 

Convience class for representing Exceptions_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** This is the struct where the exceptions table are located. 

* <br><br> 

* This attribute can only appear once in a method_info struct. 

public final class Exceptions_attribute extends attribute_inf o ( 

public int number_of _exceptions ; 
public int[] exception_index_table; 

public Exceptions_attribute(ClassFile cf, int ani, int al, int noe, 
int[] eit){ 

super (cf ) ; 

attribute_name_index = ani; 
attribute_length = al; 
number_of_exceptions » noe; 
exception_index_table = eit; 

) 

/** Used during input serialization by ClassFile only. */ 
Exceptions_attribute (ClassFile cf, DatalnputStream in) 

throws IOExceptionf 

super (cf, in); 

number_of_exceptions = in.readChar () ; 

exception_index_table = new int [number of exceptions); 
for (int i-0; i<number_of_exceptions; i++) 
^ exception_index_table[i] - in.readChar () ; 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 
throws IOException{ 

attribute_length = 2 + (number_of_exceptions*2) ; 
super . serialize (out) ; 
out.writeChar (number_of_exceptions) ; 
for (int i=0; i<number_of_exceptions; i++) 
out. writeChar (exception index tabled]); 

) 



A30. field_info.java 

Convience class for representing fieldjnfo structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Represents the field_info structure as specified in the JVM specification. 

public final class field_info{ 

public int access_f lags; 
public int name_index; 
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public int descriptor_index; 
public int attributes_count; 
public attribute_info[] attributes; 

5 /** Convenience constructor. */ 

public field_info(ClassFile cf, int flags, mt ni, wit dx) { 
access_flags = flags; 
name_index = ni; 
descriptor_index = di; 
10 attributes_count = 0; 

attributes » new attribute_inf o [0] ; 

) 

/** Constructor called only during the serialization process. 
15 * <br><br> . . 

* This is intentionally left as package protected as we 

* should not normally call this constructor directly. 

* Warningt the handling of len is not correct (after String s - 

20 */ 

field_info<ClassFile cf, DatalnputStream in) , 
throws lOException{ 
access_flags = in. readChar () ; 
name_index = in . readChar ( ) ; 
25 descriptor_index = in . readChar () ; 

attributes count = in. readChar () ; 

attributes - ' new attribute_info [attributes_count] ; 
for (int i=0; i<attributes_count; i++) { 
30 strings =' cf.constant_pool[ in. readChar ()].toString( ), ■ 

in. reset (); 

if ( S . equals ("ConstantValue") ) 

attributes [i] = new ConstantValue_attribute (-cf , xn) ; 
else if (s. equals ("Synthetic")) • . 

35 attributes [i] = new Synthetic_attribute(cf, xn) ; 

else if (s. equals ("Deprecated")) . w t , , 

attributes [i] = new Deprecated_attrxbute (cf , xn) , 

elSe attributes[i] = new attribute_info. Unknown (cf , in) ; 

40 ) 

> 

/** To serialize the contents into the output format. 

45 public void serialize (DataOutputStream out) 

throws IOException{ 

out.writeChar (access_f lags) ; 

out.writeChar (name_index) ; 

out . writeChar (descriptor_index) ; 
50 out.writeChar (attributes_count> ; 

for (int i=0; i<attributes_count; i++) 
attributes [i] . serialize (out) ; 



55 ) 



A31.InnerClassesattribute.java 

Convience class for representing InnerClasses_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A variable length structure that contains information about an 
* inner class of this class. 
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public final class InnerClasses_attribute extends attribute_inf o { 

public int number__of__classes; 
public classes [] classes; 

public final static class classes { 
int inner_class_info_index; 
int outer_class_info_index; 
int inner_name_index; 
int inner_class_access_flags; 

) 

public InnerClasses_attribute(ClassFile cf, int ani, int al, 
int noc, classes [] c) { 

super (cf) ; 

attribute_name_index = ani; 
attribute_length = al; 
number_o£_classes = noc; 
classes = c; 

) 

/** Used during input serialization by ClassFile only. */ 
InnerClasses_attribute(ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

number_of_classes = in. readChar () ; 

classes = new InnerClasses_attribute . classes [number_of_classes] ; 
for (int i=0; i<number_of_classe3; i++) { 
classes [i] = new classes (); 

classes [i] . inner_class_inf o_index = in . readChar () ; 
classes [i] . outer_class_inf o_index = in . readChar () ; 
classes [i] . inner~name_index = in. readChar () ; 
classes [i] . inner_class_access__f lags = in. readChar () ; 

) 

) 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStreara out) 
throws IOException ( 

attribute_length = 2 + (nuntber_of_classes * 8); 

super. serialize (out) ; 

out.writeChar (number_of_classes) ; 

for (int i=0; i<number_of_classes; i++) { 

out. writeChar (classes [i] .inner_class_inf o_index) ; 

out. writeChar (classes [x] .outer_class_inf o_index) ; 

out. writeChar (classes [i] .inner_name_index) ; 

out. writeChar (classes [i) . inner_class_access_f lags) ; 

) 

) 



A32. LineNumberTabIe_attribute.java 

Convience class for representing LineNumberTable_attribute structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Determines which line of the binary code relates to the 
* corresponding source code. 

public final class LineNumberTable_attribute extends attribute_info( 
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public int line_number_table_JLength; 

public line_number_table[] line_number_table; 

public final static class line_number_table{ 
int start_pc; 
int line number; 



super {cf ) ; 

attribute_name_index - ani; 
attribute_length = al; 
line_number_table_length = lntl; 
line_number_table = Int; 

} 

/** Used during input serialization by ClassFile only. */ 
LineNumberTable_attribute (ClassFile cf, DatalnputStream in) 

throws IOException( 

super (cf , in) ; 

line_number_table_length = in. readChar () ; 
line_number_table = new 
LineNumberTable_attribute . line__number_table [line_number_table_length] ; 
for (int i=0; i<line_number_table_length; i++) ( 

line_number_table [i] = new line_number_table ( ) ; 

line_number_table[i] .start_pc = in . readChar ( ) ; 

line_number_table[i] .line_number = in . readChar () ; 

) 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStreara out) 
throws IOException( 

attribute_length = 2 + (line_number_table_length * 4); 
super . serialize (out) ; 

out . writeChar (line_number_table_length) ; 

for (int i=0; i<line_number_table_length; i++) { 

out. writeChar (line_number_table[i] .start_pc) ; 

out. writeChar (line_number_table [i] . line_nuraber) ; 

) 

} 



A33.LocaIVariabIeTabIe_attribute.java 

Convience class for representing LocalVariableTable_attribute structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 



k Used by debugger 1 



find out how the source file line number is linked 

3 the J binary = code. It has many to one correspondence and is found in 
the Code_attribute. 



public final class LocalVariableTable_attribute extends attribute_inf o{ 

public int local_variable_table_length; 

public local_variable_table[] local_variable_table; 

public final static class local_variable_table{ 
int start_pc; 
int length; 
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int name_index; 
int descriptor^ 



public LocalVariableTable_attribute (ClassFile of, int ani, int al. 

int lvtl, local_vanable_tablelJ lvtH 

super (cf ) ; 

attribute_name_index = ani; 
attribute_length = al; 
local_variable_table_length = lvtl; 
local_variable_table = lvt; 

) 

/** Used during input serialization by ClassFile only. */ _ 
LocalVariableTable_attribute(ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

local_variable_table_length - in . readChar ( ) ; 
LocalVariable?Ib^e!ait7ibSi^IocaI_variable_table [local_yariable_table_length] ; 
for (int i=0; i<local_variable_table_length; i++) { 

local variable_table[i] = new local_variable_table ( ) ; 

local variable_table[il . start_pc = in . readChar () ; 

local_variable_table[i] .length = in. readChar () ; 

local variable table [i] . name_index = in . readChar ( ); 

local>ariable_table[i] . descriptor_index = in . readChar () ; 

local_variable_table[i] .index - in . readChar () ; 

) 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 
throws IOExceptionl 

attribute_length = 2 + (local_variable_table_length 10), 
super .serialize (out) ; 

out.writeChar (local_variable_table_length) ; 

for (int i=0; i<local_variable_table_length; i++) { 

out.writeChar (local_variable_table [i] .start_pc) ; 

out.writeChar (local_variable_table[i) .length) ; 

out.writeChar (local_variable_table [i] .narae_index) ; 

out.writeChar (local_variable_table[i) .descriptor_index) ; 

out.writeChar (local_variable_table [i] .index) ; 



A34. methodjnfo.java . . 

Convience class for representing methodjnfo structures within ClassFUes. 

import java.lang.*; 
import java.io.*; 

/"This follows the method_info in the JVM specification. 

public final class method_info { 

public int access_f lags; 
public int name_index; 
public int descriptor_index; 
public int attributes_count; 
public attribute_info[] attributes; 

/** Constructor. Creates a method_info, initializes it with 
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* the flags set, and the name and descriptor indexes given. 

* A new uninitialized code attribute is also created, and stored 

* in the <i>code</i> variable.*/ 

public method_info (ClassFile c.f, int flags, int ni, int di, 
int ac, attribute_inf o [] a) { 
access_flags = flags; 
name_index = ni; 
descriptor_index = di; 
attributes_count = ac; 
attributes = a; 



/** This method creates a method_info from the current pointer in the 

* data stream. Only called by during the serialization of a complete 

* ClassFile from a bytestream, not normally invoked directly. 
*/ 

method_info (ClassFile cf, DatalnputStream in) 
throws IOException{ 
access_flags - in . readChar ( ) ; 
name_index = in . readChar () ; 
descriptor_index = in . readChar () ; 
attributes_count <= in . readChar () ; 

attributes = new attribute_info [attributes_count] ; 
for (int i=0; i<attributes_count; i++) ( 
in. mark (2) ; 

String s = cf . constant_pool [in. readChar ()]. toString () ; 

in. reset () ; 

if (s. equals ("Code")) 

attributes [i] = new Code_attribute (cf , in); 
else if (s .equals ("Exceptions") ) 

attributes [i] = new Exceptions^attribute (cf , in) ; 
else if (s.equals("Synthetic") ) 

attributes [i] = new Synthetic_attribute (cf , in); 
else if ( s. equals ("Deprecated") ) 

attributes [i] = new Deprecated_attribute (cf , in); 

else 

attributes!!) = new attribute_inf o. Unknown (cf, in) ; 



/** Output serialization of the method_info to a byte array. 

* Not normally invoked directly. 
*/ 

public void serialize (DataOutputStream out) 
throws IOException{ 
out. writeChar (access_f lags) ; 
out.writeChar (name_index) ; 
out. writeChar (descriptor_index) ; 
out.writeChar (attributes_count) ; 
for (int i=0; i<attributes_count; i++) 
attributesEi] . serialize (out) ; 



A35. SourceFile_attribute.java 

Convience class for representing SourceFile_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A SourceFile attribute is an optional fixed_length attribute in 
* the attributes table. Only located in the ClassFile struct only 
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* once. 

public final class SourceFile_attribute extends attribute_inf o { 
public int sourcef ile_index; 

public SourceFile_attribute(ClassFile cf, int ani, int al, int sfi) { 
super (cf ) ; 

attribute_name_index = ani; 
attribute_length = al; 
sourcef ile_index = sfi; 

} 

/** Used during input serialization by ClassFile only. */ 
SourceFile_attribute(ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

sourcefile_index = in . readchar () ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

attribute_length = 2; 

super. serialize (out) ; 

out. writeChar (sourcef ile_index) ; 

} 



A36.Synthetic_attribute.java 

Convience class for representing Synthetic_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A synthetic attribute indicates that this class does not have 

* a generated code source. It is likely to imply that the code 

* is generated by machine means rather than coded directly. This 

* attribute can appear in the classfile, method_info or field_info. 

* It is fixed length. 

public final class Synthetic_attribute extends attribute_inf o ( 
public Synthetic_attribute (ClassFile cf, int ani, int al) { 
super (cf); 

attribute_name_index = ani; 
attribute_length = al; 

) 

/** Used during output serialization by ClassFile only. */ 
Synthetic_attribute (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

} 



ANNEXUREB 

Bl 

Method <clinit> 
0new#2<Classtest> 
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3 dup 

4 invokespecial #3 <Method test0> 
7 putstatic #4 <Field test thisTest> 
10 return 

B2 

Method <clinit> 
0 invokestatic #3 <Method boolean isAlreadyLoaded()> 

3 ifeq 7 

6 return 

7 new #5 <Class test> 

10 dup 

1 1 invokespecial #6 <Method test0> 
14 putstatic #7 <Field test thisTest> 
17 return 

B3 

Method <init> 

0 aload_0 

1 invokespecial #1 <Method java.lang.Object()> 

4 aload_0 

5 invokestatic #2 <Method long currentTimeMillis()> 

8 putfield #3 <Field long timestamp> 
1 1 return 

B4 

Method <init> 

0 aload_0 

1 invokespecial #1 <Method java.lang.Object()> 

4 invokestatic #2 <Method boolean isAlreadyLoadedO> 

7 ifeq 11 

10 return 

11 aload_0 

12 invokestatic #4 <Method long currentTimeMillisO> 

15 putfield #5 <Field long timestamp> 

18 return 
B5 

Method <clinit> 

0 ldc #2 <String "test"> . 

2 invokestatic #3 <Method boolean isAlreadyLoadedOava.lang.Stnng)> 

5 ifeq 9 

8 return 

9 new #5 <Class test> 

12 dup 

13 invokespecial #6 <Method testQ> 

16 putstatic #7 <Field test thisTest> 

19 return 
B6 

Method <init> 

0 aload_0 

1 invokespecial #1 <Method java.lang.Object0> 
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4 aload_0 

5 invokestatic U2 <Method boolean isAlreadyLoaded(java.lang.Object)> 
8 ifeq 12 

11 return 

12aload_0 

13 invokestatic #4 <Method long currentTimeMillis()> 
16 putfield #5 <Field long timestamp> 
1 9 return 

ANNEXUREB7 

This excerpt is the source-code of InitClient, which queries an "initialisation server" for 
the initialisation status of the relevant class or object. 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class InitClient { 

/** Protocol specific values. */ 

public final static int CLOSE = -1; 

public final static int NACK = 0; 

public final static int ACK = 1; 

public final static int INITIALIZE_CLASS = 10; 

public final static int INITIAIjIZE_OBJECT = 20; 

/** InitServer network values. */ 

public final static String serverAddress ■ 

System. getProperty ( "InitServer_network_address") ; 
public final static int serverPort = 

Integer. parselnt (System. getProperty ("InitServer_network_port ') ) ; 

/** Table of global id's for local objects. (hashcode-to-globallD 
mappings) */ 

public final static Hashtable hashCodeToGloballD = new Hashtable () ; 

/** Called when a object is being initialized. */ 
public static boolean isAlreadyLoaded (Object o) { 

// First of all, we need to resolve the globallD 

// for object 'o'. To do this we use the hashCodeToGloballD 

int globallD = ((Integer) hashCodeToGloballD. get (o) ). intValue () ; 
try | 

// Next, we want to connect to the InitServer, which will inform us 
// of the initialization status of this object. 
Socket socket = new Socket (serverAddress, 3erverPort) ; 
DataOutputStream out = 

new DataOutputStream ( socket. getOutputStream ( ) ) ; 
DatalnputStream in = 

new DatalnputStream ( socket. getlnputStreamO ) ; 

// Ok, now send the serialized request to the InitServer. 
out.writelnt (INITIALIZE_OBJECT) ; 
out.writelnt (globallD) ; 
out. flush!) ; 

// This is a blocking call. So we 
// will wait until the remote side 
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// sends something. 

if (status == NACK) { 

throw new AssertionError ( 

"Negative acknowledgement. Request failed."); 
Jelse if (status != ACK) { 

throw new AssertionError ( "Unknown acknowledgement: " 
+ status + ". Request failed."); 

} 

// Next, read in a 32bit argument which is the count of previous 

// initializations. 

int count = in . readlnt () ; 

//If the count is equal to 0, then this is the first 
// initialization, and hence isAlreadyLoaded should be false. 
//If however, the count is greater than 0, then this is already 
// initialized, and thus isAlreadyLoaded should be true, 
boolean isAlreadyLoaded = (count == 0 ? false : true) ; 

// Close down the connection, 
out. writelnt (CLOSE) ; 
out. flush () ; 
out. close () ; 
in. close () ; 

socket. close () ; // Make sure to close the socket. 

// Return the value of the isAlreadyLoaded variable, 
return isAlreadyLoaded; 

} catch (IOException e) ( 

throw new AssertionError ("Exception: " + e.toStringO ) ; 



/** Called when a class is being initialized. */ 
public static boolean isAlreadyLoaded (String name) ( 

try( 

// First of all, we want to connect to the InitServer, which will 
// inform us of the initialization status of this class. 
Socket socket - new Socket (serverAddress, serverPort) ; 
DataOutputStream out = 

new DataOutputStream(socket.getOutputStream() ) ; 
DatalnputStream in = 

new DatalnputStream (socket . getlnputstream ( ) ) ; 

// Ok, now send the serialized request to the InitServer. 
out. writelnt (INITIALIZE_CLASS) ; 

out. writelnt (name. length ()); // A 32bit length argument of 

// the String name. 

out. write (name . getBytes () , 0, name . length ()) ; // The byte- 

// encoded 
// String name. 

out. f lush () ; 

// Now wait for the reply. 

int status = in. readlnt (); // This is a blocking call. So we 

// will wait until the remote side 
// sends something. 

if (status == NACK) ( 

throw new AssertionError ( 
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"Negative acknowledgement. Request failed."); 
Jelse if (status != ACK) { 

throw new AssertionError ("Unknown acknowledgement: " 
+ status + ". Request failed."); 



// Next, read in a 32bit argument which is the count of the 
// previous intializations . 
int count = in . readlnt () ; 

// If the count is equal to 0, then this is the first 

// initialization, and hence isAlreadyLoaded should be false. 

// If however, the count is greater than 0, then this is already 

// loaded, and thus isAlreadyLoaded should be true. 

boolean isAlreadyLoaded = (count == 0 ? false : true); 

// Close down the connection, 
out. writelnt (CLOSE) ; 
out. flush () ; 
out. close () ; 
in. close () ; 

socket. close () ; // Make sure to close the socket. 

// Return the value of the isAlreadyLoaded variable, 
return isAlreadyLoaded; 

Jcatch (IOException e) ( 

throw new AssertionError ( "Exception : " + e.toStnng () ) ; 



ANNEXURE B8 

This excerpt is the source-code of InitServer, which receives an initialisation status query 
by InitClient and in response returns the corresponding status. 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class InitServer implements Runnable{ 

/** Protocol specific values */ 

public final static int CLOSE = -1; 

public final static int NACK - 0; 

public final static int ACK = 1; 

public final static int INITIALIZE_CLASS = 10; 

public final static int lNITIALIZE_OBJECT= 20; 

/** InitServer network values. */ 

public final static int serverPort = 20001; 

/** Table of initialization records. */ 

public final static Hashtable initializations - new Hashtable 0 ; 

/** Private input/output objects. */ 
private Socket socket = null; 
private DataOutputStream outputStream; 
private DatalnputStream inputStream; 
private String address; 

public static void main (Stringt] s) 
throws Exception! 
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System . out . println ( " InitServer_networ k_address=" 

+ InetAddress.getLocalHostO .getHostAddress () ) ; 
System. out. println < " InitServer_network_port=" + serverPort) ; 

// Create a serversocket to accept incoming initialization operation 



while ( [Thread. interrupted () ) { 

// Block until an incoming initialization operation connection. 
Socket socket = serverSocket. accept () ; 

// Create a new instance of InitServer to manage this 
// initialization operation connection, 
new Thread(new InitServer (socket) ) .start () ; 



/** Constructor. Initialize this new InitServer instance with necessary 

resources for operation. */ 
public InitServer (Socket s) ( 
socket = s; 

ry 0 utputStream = new DataOutputStream (s .getOutputStreamO ) ; 
inputStream = new DataInputStream(s .getlnputStream ( ) ) ; 
address = s . getlnetAddress () . getHostAddress ( ) ; 
) catch (lOException e) { 

throw new AssertionError ( "Exception : " + e . toString ( ) ) ; 

) 

/** Main code body. Decode incoming initialization operation requests and 

execute accordingly. */ 
public void run() { 



// All commands are implemented as 32bit integers. 

// Legal commands are listed in the "protocol specific values 

// fields above. 

int command = inputStream. readlnt () ; 

// Continue processing commands until a CLOSE operation, 
while (command != CLOSE) ( 

if (command - INITIALIZE_CLASS ) , // 

II operation. 

// Read in a 32bit length field '1', and a String name for 

// this class of length '1'. 

int length = inputStream. readlnt 0 ; 

byte[] b = new byte [length] ; 

inputStream. read (b, 0, b. length) ; 

String className = new String(b, 0, length); 

// Synchronize on the initializations table in order to 
// ensure thread-safety, 
synchronized (initializations) { 

// Locate the previous initializations entry for this 

integer S ent^y a = y (Integer) initializations . get (className) ; 
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if (entry — null) { // This is an unknown class so 
// update the table with a 
// corresponding entry. 

initializations. put (className, new Integer (D); 

// Send a positive acknowledgement to InitClient, 

// together with the count of previous initializations 

// of this class - which in this case of an unknown 

// class must be 0. 

outputStream. writelnt (ACK) ; 

outputStream.writelnt(O) ; 

outputStream. flush () ; 

}else( // This is a known class, so update 

// the count of initializations. 

initializations .put (className, 

new Integer (entry. intValueO + 1) ) ; 

// Send a positive acknowledgement to InitClient, 

// together with the count of previous initializtions 

// of this class - which in this case of a known class 

// must be the value of "entry. intValue () " . 

outputStream. writelnt (ACK) ; 

outputStream. writelnt (entry . intValue ( ) ) ; 

outputStream . flush ( ) ; 



■lse if (command == INITIALIZE OBJECT) { // This is an 

~ II INITIALIZE_OBJECT 

// operation. 

// Read in the globallD of the object to be initialized, 
int globallD - inputStream. readlnt () ; 

// synchronize on the initializations table in order to 
// ensure thread-safety, 
synchronized (initializations) ( 

// Locate the previous initializations entry for this 
// object, if any. 

Integer entry = (Integer) initializations . get ( 
new Integer (globallD) ) ; 

if (entry — null) { // This is an unknown object so 
// update the table with a 
// corresponding entry. 

f Integer (globallD) , 



// Send a positive acknowledgement to InitClien 
// together with the count of previous initiali 
//of this object - which in this case of an unknown 
// object must be 0. 
outputStream. writelnt (ACK) ; 
outputStream. writelnt (0) ; 
outputStream. flush () ; 



// This is a known object so update the 
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// count of initializations. 

initializations .put (new Integer (globallD) , 
new Integer (entry. intValueO + 1) ) ; 

// Send a positive acknowledgement to InitClient, 
// together with the count of previous initializations 
// of this object - which in this case of a known 
// object must be value "entry. intValue ()" . 
10 outputStream. writelnt (ACK) , - 

outputStream. writelntfentry. intValueO ) ; 
outputStream. flush () ? 



;lse( // Unknown command, 

throw new AssertionError ( 

"Unknown command. Operation failed. 1 



Jcatch (Exception e) ( 

throw new AssertionError ("Exception: " + e . toString ( ) ) ; 
} finally ( 

try) 

// Closing down. Cleanup this connection. 
outputStream. flush () ; 
outputStream. close () ; 
inputStream. close ( ) ; 
socket. close () ; 
Jcatch (Throwable t) ( 
t.printStackTraceO ; 

> 

II Garbage these references. 
outputStream = null; 
inputStream = null; 
socket = null; 



ANNEXUREB9 

50 This excerpt is the source-code of the example application used m the before/after 
examples of Annexure B. 

import java.lang.*; 
public class example ( 

55 

/** Shared static field. */ 

public static example currentExample; 

/** Shared instance field. */ 
60 public long timestamp; 

/** Static intializer. (clinit) */ 
static! 
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timestamp = System. currentTimeMillis () ; 



) 

ANNEXUREB10 

InitLoader.java 

This excerpt is the source-code of InitLoader, which modifies an application as it is being 
loaded. 

import java.lang.*; 
import java.io.*; 
import java.net.*; 

public class InitLoader extends URLClassLoader { 



ClassFile cf = null; 
try{ 

BufferedlnputStream in = new 

Buf feredlnputStream (f indResource (name . replace ( ' . ' , 
' /' ) .concat (" .class") ) . openStream ( ) ) ; 

cf = new ClassFile (in) ; 

}catch (Exception e) {throw new ClassNotFoundException (e . toString ( ) ) ; ) 

for (int i=0; i<cf .methods_count; i++) { 

// Find the <clinit> method_info struct. 
String methodName = cf . constantjpool [ 

cf .methods [i] .name_index] .toStringO ; 
if (! methodName. equals ("<clinit>") ) { 

continue; 

) 

// Now find the Code_attribute for the <clinit> method, 
for (int j=0; j<cf .methods [ij . attributes_count; j++) ( 

if ( ! (cf .methods[i] .attributes [j ] instanceof Code_attribute) ) 
continue; 

Code_attribute ca = (Code_attribute) cf .methods [i] . attributes [j ] ; 

// First, shift the code[] down by 4 instructions. 
byte[)[J code2 - new byte [ca .code . length+4] [] ; 
System. arraycopy (ca . code, 0, code2, 4, ca . code . length) ; 
ca.code = code2; 
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// Then enlarge the constant_pool by 7 items. 
cp_info[] cpi = new cp_info [cf . constant_pool . length+7 ] ; 
System. arraycopy (cf .constant_pool, 0, cpi, 0, 

cf . constant_pool . length) ; 
cf .constant_pool = cpi; 
cf .constant_pool_count += 7; 

// Now add the constant pool items for these instructions, starting 
// with String. 

CONSTANT_String_info csi = new CONSTANT_String_inf o ( 

( (CONSTANT_Class_info)cf . constant_pool [cf .this_class] ) .name_index) ; 
cf .constant_pool[cf .constant_pool. length-7] = csi; 

// Now add the UTF for class. 

CONSTANT_Utf8_info ul ■= new CONSTANT_Utf B_info ("InitClient") ; 
cf .constant_pool[cf . constant_pool . length- 6] = ul; 

// Now add the CLASS for the previous UTF. 
CONSTANT_Class_info cl - 

new CONSTANT_Class_info (cf ,constant_pool . length-6) ; 
cf .constant_pool[cf . constant_pool . length-5] = cl; 

// Next add the first UTF for NameAndType. 

ul = new C0NSTANT_Utf8_info("isAlreadyLoaded") ; 

cf .constant_pool[cf . constant_pool . length- 4] - ul; 

// Next add the second UTF for NameAndType. 

ul - new C0NSTANT_Utf8_info("(Ljava/lang/String;)Z"); 

cf .constant_pool[cf . constant_pool . length-3] = ul; 

// Next add the NameAndType for the previous two UTFs. 
CONSTANT_NameAndType_info nl = new CONSTANT_NameAndType_inf o ( 

cf .constant_pool.length-4, cf.constant_pool. length-3) ; 
cf .constant_pool[cf .constant_pool. length- 2] = nl; 

// Next add the Methodref for the previous CLASS and NameAndType. 
CONSTANT_Methodref_info ml = new CONSTANT_Methodref_inf o ( 
cf . constant_pool . length-5, cf . constant_pool . length-2 ) ; 
cf .constant_pool[cf . constant_pool . length-1] = ml; 

// Now with that done, add the instructions into the code, starting 
// with LDC. 

ca.codelO] = new byte [3]; 
ca.code[0] [0] = (byte) 19; 

ca.code[0] [1] = (byte) (( (cf. constant_pool . length-7) » 8) & Oxf f ) ; 
ca.code[0) [2] =• (byte) ( (cf.constant_pool. length-7) s Oxf f ) ; 

// Now Add the INVOKESTATIC instruction, 
ca.codetl] = new byte[3]; 
ca.code[l] [0] = (byte) 184; 

ca.codetl] [1] = (byte) (( (cf. constant_pool . length-1) » 8) s Oxff ) ; 
ca.code[l] [2] = (byte) ( (cf. constant_pool . length-1) & Oxf f ) ; 

// Next add the IFEQ instruction. 

ca.code[2) = new byte [3]; 

ca.code[2] [0] - (byte) 153; 

ca.code[2] [1] = (byte) ((4 » 8) & Oxf f ) ; 

ca.code[2] [2] = (byte) (4 s Oxf f ) ; 

// Finally, add the RETURN instruction. 
ca.code[3] = new byte[l); 
ca.code[3] [0] - (byte) 177; 

// Lastly, increment the CODE_LENGTH and ATTRIBUTE_LENGTH values. 
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ca.code_length +- 10; 

ca . attribute_length +=■ 10; 



Stream out = new ByteArrayOutputStream( ) ; 



byte[] b = out . toByteArray () ; 

return def ineClass (name, b, 0, b. length) 

} catch (Exception e) ( 
e . printStackTrace ( ) ; 

throw new ClassNotFoundException (name) ; 



25 ) 

Annexure C 

C 1 . TYPICAL PRIOR ART FINALIZATION FOR A SINGLE MACHINE: 
Method finalize() 

0 getstatic #9 <Field java.io.PrintStream out> 
30 3 ldc #24 <String "Deleted..."> 

5 invokevirtual #16 <Method void println(java.lang.String)> 
8 return 

C2. PREFERRED' FINALIZATION FOR MULTIPLE MACHINES 
Method finalize() 

35 0 invokestatic #3 <Method boolean isLastReference()> 

3 ifne 7 

6 return 

7 getstatic #9 <Field java.io.PrintStream out> 

10 ldc #24 <String "Deleted..."> 

40 12 invokevirtual #16 <Method void println(java.lang.String)> 

15 return . . 
C3 . PREFERRED FINALIZATION FOR MULTIPLE MACHINES (Alternative) 

Method Final ize() 
0 aload_0 

45 1 invokestatic #3 <Method boolean isLastReference(java.lang.Object)> 

4 ifne S 

7 return 

8 getstatic #9 <Field java.io.PrintStream but> 

1 1 ldc #24 <String "Deleted..."> 

50 13 invokevirtual #16 <Method void printlnGava.lang.String)> 

16 return 

Annexure C4 

import java.lang.*; 
55 public class example ( 
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/** Finalize method. */ 

protected void finalize () throws Throwable{ 

// "Deleted..." is printed out when this object is garbaged. 
System. out. println ( "Deleted. . .") ; 



Annexure C5 

java.lang.*; 
java.util.*; 
java.net.*; 
j ava . io . * ; 

public class FinalClient{ 

/** Protocol specific values. */ 

public final static int CLOSE = -1; 

public final static int NACK = 0; 

public final static int ACK = 1; 

public final static int FINALIZE_OB JECT = 10; 

/** FinalServer network values. */ 

public final static String serverAddress » 

System. getProperty ( "FinalServer_network_address " ) ; 
public final static int serverPort = 

Integer. parselnt (System. getProperty ("FinalServer_network_port") ) ; 

/** Table of global ID's for local objects. (hashcode-to-globallD 
mappings) */ 

public final static Hashtable hashCodeToGloballD = new Hashtable (); 

/** Called when a object is being finalized. */ 
public static boolean isLastReference (Object o) { 

// First of all, we need to resolve the globallD for object 'o'. 

// To do this we use the hashCodeToGloballD table. 

int globallD = ((Integer) hashCodeToGloballD. get (o) ). intValue () ; 

try( 

// Next, we want to connect to the FinalServer, which will inform 
// us of the finalization status of this object. 
Socket socket = new Socket (serverAddress, serverPort); 
DataOutputStream out = 

new DataOutputStream(socket.getOutputStream() ) ; 
DatalnputStream in » new DatalnputStream (socket . getlnputStream ()) ; 

// Ok, now send the serialized request to the FinalServer. 
out . write Int (FINALIZE_OBJECT) ; 
out.writelnt (globallD) ; 
out. flush () ; 

// Now wait for the reply. 

int status = in . readlnt ( ) ; // This is a blocking call. So we 

// will wait until the remote side 
// sends something. 

if (status — NACK) { 

throw new AssertionError ( 

"Negative acknowledgement. Request failed."); 
Jelse if (status != ACK) { 

throw new AssertionError ("Unknown acknowledgement: " 
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+ status + ", Request failed."); 



// Next, read in a 32bit argument which is the count of the 
// remaining f inalizations 
int count = in . readlnt ( ) ; 

// If the count is equal to 1, then this is the last f inalization, 
// and hence isLastRef erence should be true. 

// If however, the count is greater than 1, then this is not the 
// last f inalization, and thus isLastRef erence should be false, 
boolean isLastRef erence = (count == 1 ? true : false) ; 

// Close down the connection, 
out. writelnt (CLOSE) ; 
out. f lush () ; 
out. close () ; 
in. close () ; 

socket. close () ; // Make sure to close the socket. 

// Return the value of the isLastRef erence variable, 
return isLastRef erence; 

) catch (IOException e) ( 

throw new AssertionError ("Exception: " + e . toString ( ) ) ; 



Annexure C6 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class FinalServer implements Runnable( 

/** Protocol specific values */ 

public final static int CLOSE - -1; 

public final static int NACK = 0; 

public final static int ACK = 1; 

public final static int FINALIZE_OBJECT = 10; 

/** FinalServer network values. */ 

public final static int serverPort = 20001; 

/** Table of finalization records. */ 

public final static Hashtable f inalizations = new HashtableO; 

/** Private input/output objects. */ 
private Socket socket - null; 
private DataOutputStream outputstream; 
private DatalnputStream inputstreara; 
private String address; 

public static void main (String [] s) 
throws Exception! 

System . out . println ( "FinalServer_network_address=" 

+ InetAddress.getLocalHostO .getHostAddress () ) ; 
System. out. println ("FinalServer_network_port=" + serverPort) ; 

// Create a serversocket to accept incoming initialization operation 
// connections. 
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ServerSocket serverSocket = new ServerSocket (serverPort) ; 

while ( iThread. interrupted!) ) { 

// Block until an incoming initialization operation connection. 
Socket socket = serverSocket. accept () ; 

// Create a new instance of InitServer to manage this 

// initialization operation connection. 

new Thread(new FinalServer (socket) ). start () ; 



/** Constructor. Initialize this new FinalServer instance with necessary 

resources for operation. */ 
public FinalServer (Socket s) ( 

socket = s; 

try{ 

outputstream = new DataOutputStream (s .getOutputStream( ) ) ; 
inputstream = new DataInputStream( s . getlnputStreamO ) ; 
address = s . getlnetAddress ( ) . getHostAddress ( ) ; 
} catch (IOException e) { 

throw new AssertionError ( "Exception : " + e . toString ( ) ) ; 

) 

) 

/** Main code body. Decode incoming finalization operation requests and 

execute accordingly. */ 
public void run () ( 



// All commands are implemented as 32bit integers. 

// Legal commands are listed in the "protocol specific values" 

// fields above. 

int command «■ inputstream. readlnt <) ; 

// Continue processing commands until a CLOSE operation, 
while (command !- CLOSE) ( 

if (command == FINALIZE OBJECT) ( // This is a 

// FINALIZE_OBJECT 
// operation, 

// Read in the globallD of the object to be finalized, 
int globallD = inputstream, readlnt () ; 

// Synchronize on the f inalizations table in order to ensure 
// thread-safety, 
synchronized (f inalizations) { 

// Locate the previous finalizations entry for this 
// object, if any. 

Integer entry = (Integer) finalizations . get ( 
new Integer (globallD) ) ; 

if (entry — null) { 

throw new AssertionError ( "Unknown object."); 
)else if (entry. intValuef) < 1) ( 

throw new AssertionError ("Invalid count."); 
(else if (entry. intValueO == 1) ( // Count of 1 means 
// this is the last 
// reference, hence 
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// remove from table. 

f inalizations . remove (new Integer (globallD) ) ; 

// Send a j 
// togethei 

// which in this case is 1. 
outputStream.writelnt (ACK) ; 
outputStream.writelnt(l) ; 
outputStream. flush () ; 

•lse{ // This is not the last remaining 

// reference, as count is greater than 1. 
// Decrement count by 1. 

f inalizations .put (new Integer (globallD) , 
new Integer (entry. intValue () - 1)); 

// Send a positive acknowledgement to FinalClient, 
// together with the count of remaining references to 
// this object - which in this case of must be value 
// " entry. intValue ()". 
outputStream.writelnt (ACK) ; 
outputStream.writelnt (entry . intValue ( ) ) ; 
outputStream. flush () ; 



}else{ // Unknown < 

throw new AssertionError ( 

"Unknown command. Operation failed.' 



}catch (Exception e) { 

throw new AssertionError ( "Exception : " + e . toString ( ) ) ; 
} finally ( 

try( 

45 // Closing down. Cleanup this connection. 

outputStream . flush ( ) ; 

outputStream. closet) ; 

inputStream . close ( ) ; 

socket, close () ; 
50 ) catch (Throwable t) I 

t . printStackTrace ( ) ; 

) 

// Garbage these references. 
outputStream = null; 
55 inputStream = null; 

socket = null; 

} 

} 

60 

ANNEXURE C7 



FinalLoader.java 
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This excerpt is the source-code of FinalLoader, which modifies an application as it is 
being loaded. 

import j ava . lang . * ; 
import j ava . io . * ; 
import java.net.*; 

public class FinalLoader extends URLClassLoader{ 



ClassFile cf = null; 
try{ 

BufferedlnputStream in = 

new BufferedInputStream(findResource (name. replace ( ' . ' , 
' /' ) .concat (".class") ) .openStream( ) ) ; 

cf = new ClassFile (in) ; 

) catch (Exception e) (throw new ClassNotFoundException (e . toString () ) ; } 

for (int i=0; i<cf .methods_count; i++) ( 

// Find the finalize method_info struct. 
String methodName = cf . constant_pool [ 

cf. methods [i] .name_index] . toString () ; 
if ( ImethodName. equals ("finalize") ) { 

) 

// Now find the Code_attribute for the finalize method, 
for (int j=0; j<cf .methods [i] , attributes_count; j++) { 

if (! (cf. methods [i] .attributes [j] instanceof Code_attribute) ) 
continue; 

Code_attribute ca = (Code_attribute) cf .methods [i] . attributes [j ] ; 

// First, shift the code[] down by 4 instructions. 
byte[][] code2 = new byte(ca.code.length+4] [] ; 
System. arraycopy (ca . code, 0, code2, 4, ca . code . length) ; 
ca.code = code2; 

// Then enlarge the constant_pool by 6 items. 

cp info[] cpi = new cp_inf o [cf . constant_pool . length+6] ; 

System. arraycopy (cf.constant_pool, 0, cpi, 0, 

cf . constant_pool . length) ; 
cf ,constant_pool = cpi; 
cf ,constant_pool_count += 6; 

// Now add the UTF for class. 

C0NSTANT_Utf8_info ul = new CONSTANTJJtf 8_info ("FinalClient") ; 
cf. cons tant_pool[cf.constant_pool. length- 6] ■ ul; 

// Now add the CLASS for the previous UTF. 
CONSTANT_Class_info cl = 

new CONSTANT_Class_info(cf . constant_pool . length-6) ; 
cf .constant_pool (cf . constantjoool . length-5] = cl; 



// Next add the first UTF for NameAndType. 
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ul = new CONSTANT_Utf8_info("isLastReference") ; 
cf .constant_pool[cf .constant_pool.length-4] = ul; 

// Next add the second UTF for NameAndType. 

ul = new CONSTANT_Utf8_info(" (Ljava/lang/Object; ) Z") ; 

cf .constant_pool(cf . constant_pool . length-3] = ul; 

// Next add the NameAndType for the previous two UTFs . 
CONSTANT_NameAndType_info nl = new CONSTANT_NameAndType_inf o ( 

cf .constant_pool. length- 4, cf . constant_pool . length-3) ; 
cf .constant_pool[cf . constantjpool . length-2] = nl; 

// Next add the Methodref for the previous CLASS and NameAndType. 
CONSTANT_Methodref_info ml = new CONSTANT_Methodref_inf o ( 
cf .constant_pool.length-5, cf . constant_pool . length-2) ; 
cf .constant_pool [cf .constant_pool . length- 1] = ml; 

// Now with that done, add the instructions into the code, starting 
// with LDC. 

ca.code[0] = new byte[l]; 
ca.code[0] [0] = (byte) 42; 

// Now Add the INVOKESTATIC instruction. 
ca.code[l] = new byte [3]; 
ca.code[l] [0] = (byte) 184; 

ca. code[l] [1] = (byte) ( ( (cf .constant_pool.length-l) » 8) & Oxf f ) ; 
ca.code [1] [2] = (byte) ( (cf .constant_pool . length-1) £ Oxf £ ) ; 

// Next add the IFNE instruction. 

ca.code[2] = new byte[3J; 

ca.code [2] [0] = (byte) 154; 

ca.code(2] [1] = (byte) ((4 » 8) S Oxff ) ; 

ca.code [2] [2] = (byte) (4 & Oxf f ) ; 

// Finally, add the RETURN instruction, 
ca.code [3] = new byte[l]; 
ca.code [3] [0] = (byte) 177; 

// Lastly, increment the CODE_LENGTH and ATTRIBOTE_LENGTH values. 
ca.code_length += 8; 
ca.attribute_length += 8; 



n out = new ByteArrayOutputStreamO ; 



byte[] b = out.toByteArrayO ; 

return def ineClass (name, b, 0, b. length), • 

) catch (Exception e) { 
e.printStackTraceO ; 

throw new ClassNotFoundException (name) ; 
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AnnexureDl 

Method void run() 
0 getstatic #2 <Field java.lang.Object LOCK> 
3 dup 
5 4 astorej 

5 monitorenter 

6 getstatic #3 <Field int counter> 

9 iconst_l 

10 iadd 

10 11 putstatic #3 <Field int counter> 

14 aload_l 

15 monitorexit 

1 6 return 

Annexure D2 

15 Method void run() 

0 getstatic #2 <Field java.lang.Object LOCK> 

3 dup 

4 astore_l 

5 dup 

20 6 monitorenter 

7 invokestatic #23 <Method void acquireLock(java.lang.Object)> 
10 getstatic #3 <Field int counter> 

13 iconst_l 

14 iadd 

25 1 5 putstatic #3 <FieId int counter> 
18aload_l 

19 dup 

20 invokestatic #24 <Method void releaseLock(java.Iang.Object)> 

23 monitorexit 
30 24 return 

Annexure D3 

import java.lang.*; 
public class example ( 

35 

/** Shared static field. */ 

public final static Object LOCK = new ObjectO; 

/** Shared static field. */ 
40 public static int counter = 0; 

/** Example method using synchronization. This method serves to 

illustrate the use of synchronization to implement thread-safe 
modification of a shared memory location by potentially multiple 
45 threads. */ 

public void run() { 

// First acquire the lock, otherwise any memory writes we do will be 
// prone to race-conditions. 
50 synchronized (LOCK) { 

// Now that we have acquired the lock, we can safely modify memory 

// in a thread-safe manner. 

counter++; 



-177- 



WO 2006/110957 



PCT/AU2006/000532 



} 



Annexure D4 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class LockClient{ 

/** Protocol specific values. */ 

public final static int CLOSE = -1; 

public final static int NACK = 0; 

public final static int ACK = 1; 

public final static int ACQUIRE_LOCK - 10; 

public final static int RELEASE_LOCK = 20; 

/** LockServer network values. */ 

public final static String serverAddress = 

System. getProperty ( "LockServer_network_address" ) ; 
public final static int serverPort = 

Integer. parselnt (System. getProperty ("LockServer_networ k_port" ) ) ; 

/** Table of global ID'S for local objects. (hashcode-to-globallD 
mappings) */ 

public final static Hashtable hashCodeToGloballD = new Hashtable ( ) ; 

/** Called when an application is to acquire a lock. */ 
public static void acquireLock (Object o) { 

// First of all, we need to resolve the globallD for object 'o'. 

// To do this we use the hashCodeToGloballD table. 

int globallD = ((Integer) hashCodeToGloballD. get (o) ). intValue () ; 

try{ 

// Next, we want to connect to the LockServer, which will grant us 
// the global lock. 

Socket socket = new Socket (serverAddress, serverPort); 
DataOutputStream out = 

new DataOutputStream(socket.getOutputStream() ) ; 
DatalnputStream in = new DatalnputStream (socket . getlnputStream ()) ; 

// Ok, now send the serialized request to the lock server, 
out . writelnt (ACQUIRE_LOCK) ; 
out . writelnt (globallD) ; 
out . flush ( ) ; 

// Now wait for the reply. 

int status = in . readlnt () ; // This is a blocking call. So we 

// will wait until the remote side 
// sends something. 

if (status NACK) { 

throw new AssertionError ( 

"Negative acknowledgement. Request failed."); 
[else if (status != ACK) { 

throw new AssertionError ("Unknown acknowledgement: " 
+ status + ". Request failed."); 
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// Close down the connection, 
out. writelnt (CLOSE) ; 
out. f lush () ; 
out . close ( ) ; 
in. close () ; 

socket.cloaeO; // Make sure to close the socket. 

// This is a good acknowledgement, thus we can return now because 

// global lock is now acquired. 

return; 

x^pnhi on ei I 

: " + e.toStringt) ) ; 



/** Called when an application is to release a lock. */ 
public static void releaseLock (Object o) { 

// First of all, we need to resolve the globallD for object 'o'. 

// To do this we use the hashCodeToGloballD table. 

int globallD = ((Integer) hashCodeToGloballD . get (o) >. intValue () ; 



// Next, we want to connect to the LockServer, which records us as 
// the owner of the global lock for object 'o' . 
Socket socket = new Socket (serverAddress, serverPort) ; 
DataOutputStream out = 

new DataOutputStream(socket.getOutputStream() ) ; 
DatalnputStream in = new DataInputStream(socket.getInputStream() ) ; 

// Ok, now send the serialized request to the lock server, 
out. writelnt ( RELEAS E_LOCK ) ; 
out. writelnt (globallD) ; 
out. f lush () ; 

// This is a blocking call. So we 
// will wait until the remote side 
// sends something. 



if (status == NACK) ( 

throw new AssertionError ( 

"Negative acknowledgement. Request failed."); 
Jelse if (status != ACK) { 

throw new AssertionError ( "Unknown acknowledgement: 
+ status + ". Request failed."); 

) 

// Close down the connection, 
out. writelnt (CLOSE) ; 
out. flush () ; 
out. close () ; 
in. closet) ; 

socket. close () ; // Make sure to close the socket. 

// This is a good acknowledgement, return because global lock is 

// now released. 

return; 
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(catch (IOException e) { 

throw new AssertionError ( "Exception: " + e . toString { ) ) ; 



5 } 



Annexure D5 

10 import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

15 public class LockServer implements Runnable{ 

/** Protocol specific values */ 
public final static int CLOSE - -X; 
public final static int NACK = 0; 
20 public final static int ACK - 1; 

public final static int ACQUIRE_LOCK - 10; 
public final static int RELEASE_LOCK = 20; 

/** LockServer network values. */ 
25 public final static int serverPort = 20001; 

/** Table of lock records. */ 

public final static Hashtable locks - new HashtableO; 

30 /** Linked list of waiting LockManager objects. */ 

public LockServer next = null; 

/** Address of remote LockClient. */ 
public final String address; 

35 

■/** Private input/output objects. */ 
private Socket socket = null; 
private DataOutputStream outputstream; 
private DatalnputStream inputStream; 

40 

public static void main (String [] s) 
throws Exception { 

System. out . println ( "LockServer_network_address=" 
45 + inetAddress.getLocalHost().getHostAddress()); 

System. out. println ( "LockServer_network_port=" + serverPort); 

// Create a serversocket to accept incoming lock operation 
// connections. 

50 ServerSocket serverSocket = new ServerSocket (serverPort) ; 

while (IThread.interruptedO) { 

// Block until an incoming lock operation connection. 
55 Socket socket = serverSocket. accept () ; 

// Create a new instance of LockServer to manage this lock 
// operation connection. 

new Thread (new LockServer (socket) ). start () ; 

60 



1 



-180- 



WO 2006/110957 



PCT/AU2006/000532 



/** Constructor. Initialise this new LockServer instance with necessary 

resources for operation. */ 
public LockServer (Socket s) { 

socket = s; 

try{ 

outputstream = new DataOutputStream(s .getOutputStreamO ) ; 
inputStream = new DatalnputStream (s . getlnputStreamO ) ; 
address = s .getlnetAddress () .getHostAddress () ; 
} catch (lOException e) { 

throw new AssertionError ("Exception: " + e . toString ( ) ) ; 



/** Main code body. Decode incoming lock operation requests and execute 

accordingly. */ 
public void run() ( 



// All commands are implemented as 32bit integers. 

// Legal commands are listed in the "protocol specific values" 

// fields above. 

int command = inputStream. readlnt () ; 

// Continue processing commands until a CLOSE operation, 
while (command != CLOSE) ( 

if (command == ACQUIRE_LOCK) ( // This is an 

// ACQUIRE_LOCK 
// operation. 

// Read in the globallD of the object to be locked, 
int globallD = inputStream. readlnt () ; 

// Synchronize on the locks table in order to ensure thread- 
// safety. 

synchronized (locks) ( 

// Check for an existing owner of this lock. 
LockServer lock = (LockServer) locks. get ( 
new Integer (globallD) ) ; 

if (lock == null) ( // No-one presently owns this lock, 
// so acquire it. 

locks. put (new Integer (globallD) , this); 

acquireLockO ; // Signal to the client the 

// successful acquisition of this 
// lock. 

}el S e{ // Already owned. Append ourselves 

//to end of queue. 

// Search for the end of the queue. (Implemented as 
// linked-list) 
while (lock. next !=■ null) { 
lock = lock. next; 



lock. next = this; // Append this lock request at end. 
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}else if (command == RELEASE_L0CK) { // This is a 

// RELEASE_LOCK 
// operation. 

// Read in the globallD of the object to be locked, 
int globallD = inputstream. readlnt () ; 

// Synchronize on the locks table in order to ensure thread- 
// safety. 

synchronized (locks) { 

// Check to make sure we are the owner of this lock. 
LockServer lock = (LockServer) locks. get ( 
new Integer (globallD) ) ; 

if (lock == null) ( 

throw new AssertionError ( "Unlocked . Release failed."); 
Jelse if (lock. address != this . address) { 

throw new AssertionError ( "Trying to release a lock " 
+ "which this client doesn't own. Release " 
+ "failed."); 

) 



// Signal to the client the 
// successful acquisition of this 
// lock. 

// Shift the linked list of pending acquisitions forward 
// by one. 

locks .put (new Integer (globallD) , lock); 



)else( // Unknown command, 

throw new AssertionError ( 

"Unknown command. Operation failed."); 



} 

Jcatch (Exception e) ( 

throw new AssertionError ( "Exception: " + e . toString ( ) ) ; 
) finally ( 

try( 

// Closing down. Cleanup this connection. 
outputStream . flush ( ) ; 
outputStream. close () ; 
inputstream. close () ; 
socket. close() ; 
Jcatch (Throwable t) ( 
t.printStackTraceO ; 

} 

// Garbage these references. 
outputStream = null; 
inputstream » null; 
socket = null; 
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/** Send a positive acknowledgement of an ACQUIRE_LOCK operation. ' 
public void acquireLock () throws IOException{ 

outputStreara.writelnt (ACK) ; 

outputstream. flush () ; 

' ) 

/** Send a positive acknowledgement of a RELEASE_LOCK operation. *, 
public void releaseLock ( ) throws IOException{ 

outputstream. writelnt (ACK) ; 

outputstream . flush ( ) ; 

) 



ANNEXURE D6 

LockLoader.java 

This excerpt is the source-code of LockLoader, which modifies an application as it if 
being loaded. 

import java.lang.*; 
import j ava , io . * ; 
import java.net.*; 

public class LockLoader extends URLClassLoader { 



ClassFile cf = null; 
try{ 

BufferedlnputStream in = 

new BufferedlnputStream (findResource (name . replace ( ' . ' , 
' /' ) .concat(". class") ) .openStream ( ) ) ; 

cf - new ClassFile (in) ; 

(catch (Exception e) {throw new ClassNotFoundException (e . toString () ) ; ) 

// Class-wide pointers to the enterindex and exitindex. 
int enterindex ■ -1; 
int exitindex = -1; 

for (int i=0; i<cf .methods_count; i++) ( 

for (int j=0; j<cf .methods [i] . attributes_count; j++) { 

if (! (cf .methods[i] .attributes [j ] instanceof Code_attribute) ) 

Code_attribute ca - (Code_attribute) cf .methods [i] .attributes [j ] ; 
boolean changed = false; 



// Opcode for a 
// MONITORENTER 
// instruction. 
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changed = true; 

// Next, realign the code array, making room fi 
// insertions. 

byte[] [] code2 = new byte [ca. code. length+2] []; 
System. arraycopy (ca. code, 0, code2, 0, z) ; 
code2[z+l] = ca.code[z]; 

System. arraycopy (ca. code, z+1, code2, z+3, 

ca . code . length- (z+1) ) ; 
ca . code = code2 ; 



// Next, insert the DOP instruction. 
ca.code[z] = new byte[l]; 
ca.codetz] [0] = (byte) 89; 



// Finally, insert the INVOKESTATIC instruction. 

if (enterindex — -1) ( 

// This is the first time this class is encourtering the 
// acquirelock instruction, so have to add it to the 
// constant pool. 

cp_info[] cpi = new cp_inf o [cf . constant_pool . length+6] ; 
System. arraycopy (cf.constant_pool, 0, cpi, 0, 

cf.constant_pool. length) ; 
cf . constant_pool = cpi; 
cf . constant__pool_count += 6; 

CONSTANT_Utf8_info ul - 

new C0NSTANT_Utf8_info("LockClient") ; 
cf . constant_pool [cf . constant_pool . length-6] = ul; 

CONSTANT_Class_info cl = new CONSTANT_Class_inf o ( 

cf .constant_pool_count-6) ; 
cf .constant_pool[cf .constant_pool .length-5] = cl; 

ul = new C0NSTANT_Utf8_info("acquireLock") ; 

cf . constant_pool[cf . constant_pool . length-4] = ul; 

ul = new C0NSTANT_0tf8_info(" (Lj ava/lang/Object; ) V") / 
cf .constant_pool[cf . constant_pool . length-3) = ul; 

CONSTANT_NameAndType_info nl - 
new CONSTANT_NameAndType_inf o ( 

cf . constant_pool . length-4 , cf . constant_pool . length-3 ) ; 
cf ,constant_pool[cf . constant_pool . length-2] = nl; 

CONSTANT_Methodref_info ml = new CONSTANT_Methodref_info ( 
cf . constant_pool . length-5, cf . constant_pool . length-2) ; 
cf . constant_pool [cf . constant_pool . length-1] = ml; 
enterindex => cf. constant_pool . length-1; 

} 

ca.code[z+2] = new byte [3]; 
ca.code[z+2] [0] = (byte) 184; 

ca.code[z+2] [1] = (byte) ((enterindex » 8) 5 Oxff); 
ca.code[z+2) [2] = (byte) (enterindex & Oxff); 

// And lastly, increase the CODE_LENGTH and ATTRIBUTE_LENGTH 
// values. 

ca.code_length += 4; 
ca.attribute_length += 4; 



Jelse if ( (ca.codefzj [0] s Oxff) — 195) ( // Opcode for a 
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changed = true; 

// Next, realign the code array, making room for the 
// insertions. 

byte[][] code2 = new byte [ca . code . length+2] [] ; 
System. arraycopy (ca. code, 0, code2, 0, z) ; 
code2[2+l] = ca.code[z]; 

System. arraycopy (ca.code, z+1, code2, z+3, 

ca . code . length- (z+1) ) ; 
ca.code = code2; 

// Next, insert the DUP instruction. 
ca.code[z] = new byte[l); 
ca.code[z] [0] = (byte) 89; 

// Finally, insert the INVOKESTATIC instruction, 

if (exitindex == -1) { 

// This is the first time this class is encourtering the 
// acquirelock instruction, so have to add it to the 
// constant pool. 

cp_info[] cpi = new cp_inf o [cf . constant_pool . length+6] ; 
System. arraycopy (cf .constantjpool, 0, cpi, 0, 

cf . constant_pool . length) ; 
cf .constant_pool = cpi; 
cf . constant_pool_count += 6; 

CONSTANTJJtf 8_info ul = 

new CONSTANT_Utf 8_info ("LockClient" ) ; 
cf .constant_pool(cf .constant_pool . length-6] = ul; 

CbNSTANT_Class_info cl = new CONSTANT_Class_inf o ( 

cf .constant_pool_count-6) ; 
cf .constant_pool[cf .constant_pool. length- 5) = cl; 

ul = new C0NSTANT_0tf8_info("releaseLock") ; 

cf ,constant_pool[cf . constantjpool . length-4 ] = ul; 

ul = new CONSTANT_Utf8_info(" (Ljava/lang/Object; ) V") ; 
cf .constant_pool[cf .constant_pool.length-3) = ul; 

CONSTANT_NameAndType_info nl = 
new CONSTANT_NameAndType_info ( 

cf . constant_pool . length-4 , cf . constant_pool . length-3 ) ; 
cf ,constant_pool[cf .constant_pool.length-2] = nl; 

CONSTANT_Methodref_info ml = new CONSTANT_Methodref_info ( 
cf ,constant_pool.length-5, cf . constant_pool . length-2) ; 
cf .constant_pool[cf . constant_pool . length-1] = ml; 
exitindex = cf . constant_pool . length-1; 

) 

ca.code[z+2] = new byte [3J; 
ca.code[z+2) [0] = (byte) 184; 

ca.code(z+2] [1] = (byte) ((exitindex » 8) & Oxf f ) ; 
ca.code(z+2] [2] = (byte) (exitindex & Oxf f ) ; 



// And lastly, increase the CODE_LENGTH and ATTRIBUTE_IiENGTH 
60 // values. 

ca.code_length += 4; 
ca.attribute_length += 4; 



65 
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// If we changed this method, then increase the stack size by c 
if (changed) { 

ca.max stack++; // Just to make sure. 



ByteArrayOutputStream out = new ByteArrayOutputStre 
cf. serialize (out) ; 

byte[] b = out.toByteArrayO ; 

return def ineClass (name, b, 0, b. length) ; 
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CLAIMS 

1 . A single computer intended to operate in a multiple computer system which 
comprises a plurality of computers each having a local memory and each being 

5 interconnected via a communications network, wherein a different portion of at least 
one application program each written to execute on only a single computer executes 
substantially simultaneously on a corresponding one of said plurality of computers, and 
at least one memory location is replicated in the local memory of each said computer, 
said single computer comprising: 
10 a local memory having at least one memory location intended to be updated via said 
communications network, 

a communications port for connection to said communications network, and 
updating means to transfer to said communications port any updated content(s) of said 
replicated local memory Iocation(s) whereby the corresponding replicated memoiy 
1 5 location of each said computer of said multiple system can be updated via said 
communicating network and all said replicated memory locations can remain 
substantially identical. 

2. The computer as claimed in claim 1 wherein each said replicated local 
memory location is part of an independent local memory accessible only by the 

20 corresponding portion of said application program executing on said computer. 

3. The computer as claimed in claim 1 or 2 wherein said memory location 
includes at least one of an asset, object or resource and has a value or content. 

4. The computer as claimed in any one of claims 1 - 3 wherein a substantially 
identical global name is allocated to each corresponding said replicated memory 

25 location. 

5. A single computer intended to operate in a multiple computer system which 
comprises a plurality of computers each having a local memory and each being 
interconnected via a communications network, wherein a different portion of at least 
one application program each written to execute on only a single computer executes 

30 substantially simultaneously on a corresponding one of said plurality of computers, and 
at least one memory location is replicated in the local memory of each said computer, 
said single computer comprising: 

a local memory having at least one memory location intended to be updated via said 
communications network, 
35 a communications port for connection to said communications network, 

updating means to transfer to said communications port any updated content(s) of said 
replicated local memory location(s), and 

initialization means which determine the initial content or value of said replicated 
memory location and which can be disabled. 
40 6. The computer as claimed in claim 5 wherein said initialization means is 
connected to said communications port to receive an initial content or value of said 
replicated memory location via said communications network. 

7. The computer as claimed in claim 5 or 6 wherein said initialization means is 
connected to said communications port to send an initial content or value of said 

45 replicated memory location via said communications network. 

8. A single computer intended to operate in a multiple computer system which 
comprises a plurality of computers each having a local memory and each being 
interconnected via a communications network, wherein a different portion of at least 
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one application program each written to execute on only a single computer executes 
substantially simultaneously on a corresponding one of said plurality of computers, and 
at least one memory location is replicated in the local memory of each said computer, 
said single computer comprising: 
5 a local memory having at least one memory location intended to be updated via said 
communications network, 

a communications port for connection to said communications network, 

updating means to transfer to said communications port any updated content(s) of said 

replicated local memory location(s), and 

1 0 finalization means which deletes said replicated memory location when all said 

computers no longer need to refer thereto, said finalization means being connected to 
said communications port to receive therefrom data transmitted over said network 
relating to continued reference of other computers of said multiple computer system to 
said replicated memory location. 

15 9, The computer as claimed in claim 8 wherein said finalization means when 
said computer no longer needs to refer to said replicated memory location transfers to 
said communications port data indicative of the terminated reference for transmission 
via said communications network. 

10. A single computer intended to operate in a multiple computer system which 
20 comprises a plurality of computers each having a local memory and each being 

interconnected via a communications network, wherein a different portion of at least 
one application program each written to execute on only a single computer executes 
substantially simultaneously on a corresponding one of said plurality of computers, and 
at least one memory location is replicated in the local memory of each said computer, 
25 said single computer comprising: 

a local memory having at least one memory location intended to be updated via said 
communications network, 

a communications port for connection to said communications network, 
updating means to transfer to said communications port any updated content(s) of said 
30 replicated local memory location(s), and 

lock acquisition and relinquishing means to respectively permit said replicated local 
memory location to be written to, and prevent said replicated local memory being 
written to, on command. 

11. The computer as claimed in claim 10 wherein said command is received trom 
35 said communications port. 

12. The computer as claimed in claim 10 or 1 1 wherein said command is 
generated by said computer and sent to said communications port for transmission via 
said communications network. 

13. A single computer intended to operate in a multiple computer system which 
40 comprises a plurality of computers each having a local memory and each being 

interconnected via a communications network, wherein a different portion of at least 
one application program each written to execute on only a single computer executes 
substantially simultaneously on a corresponding one of said plurality of computers, and 
at least one memory location is replicated in the local memory of each said computer, 
45 said single computer comprising: 

a local memory having at least one memory location intended to be updated via said 
communications network, 

a communications port for connection to said communications network, 
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updating means to transfer to said communications port any updated content(s) of said 
replicated local memory locations) whereby the corresponding replicated memory 
location of each said computer of said multiple system can be updated via said 
communicating network and all said replicated memory locations can remain 
5 substantially identical, 

initialization means which determine the initial content or value of said replicated 
memory location and which can be disabled, 

finalization means which deletes said replicated memory location when all said 
computers no longer need to refer thereto, said finalization means being connected to 
1 0 said communications port to receive therefrom data transmitted over said network 

relating to continued reference of other computers of said multiple computer system to 
said replicated memory location, and 

lock acquisition and relinquishing means to respectively permit said replicated local 
memory location to be written to, and prevent said replicated local memory being 
15 written to, on command. 

14. The computer as claimed in claim 13 wherein each said replicated local 
memory location is part of an independent local memory accessible only by the 
corresponding portion of said application program executing on said computer. 

15. The computer as claimed in claim 13 or 14 wherein said memory location 
20 includes at least one of an asset, object or resource and has a value or content. 

16. The computer as claimed in any one of claims 13-15 wherein a substantially 
identical global name is allocated to each corresponding said replicated memory 
location, 

17. The computer as claimed in any one of claims 13-16 wherein said 

25 initialization means is connected to said communications port to receive an initial 

content or value of said replicated memory location via said communications network. 

18. The computer as claimed in any one of claims 13-17 wherein said 
initialization means is connected to said communications port to send an initial content 
or value of said replicated memory location via said communications network. 

30 19. The computer as claimed in any one of claims 13-18 wherein said finalization 

means when said computer no longer needs to refer to said replicated memory location 
transfers to said communications port data indicative of the terminated reference for 
transmission via said communications network. 

20. The computer as claimed in any one of claims 13-19 wherein said command is 
35 received from said communications port. 

21 . The computer as claimed in any one of claims 13-20 wherein said command is 
generated by said computer and sent to said communications port for transmission via 
said communications network. 

22. A multiple computer system having at least one application program each 
40 written to operate on only a single computer but running simultaneously on a plurality 

of computers interconnected by a communications network, wherein different portions 
of said application program(s) execute substantially simultaneously on different ones of 
said computers, wherein each computer has an independent local memory accessible 
only by the corresponding portion of said application program(s) and wherein for each 
45 said portion a like plurality of substantially identical objects are created, each in the 
corresponding computer. 
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23. The system as claimed in claim 22 wherein each computer has an independent 
local memory accessible only by the corresponding portion of said application 
program(s) 

24. The system as claimed in claim 22 or 23 wherein each of said plurality of 
substantially identical objects has a substantially identical name. 

25. The system as claimed in claim 24 wherein each said computer includes a 
distributed run time means with the distributed run time means of each said computer 
able to communicate with all other computers whereby if a portion of said application 
program(s) running on one of said computers changes the contents or value of an object 
in that computer then the change in content or value for said object is propagated by the 
distributed run time means of said one computer to all other computers to change the 
content or value of the corresponding object in each of said other computers. 

26. The system as claimed in claim 25 wherein each said application program is 
modified before, during, or after loading by inserting an updating propagation routine to 
modify each instance at which said application program writes to memory, said 
updating propagation routine propagating every memory write by one computer to said 
other computers. 

27. The system as claimed in claim 26 wherein the application program is 
modified in accordance with a procedure selected from the group of procedures 
consisting of re-compilation at loading, pre-compilation prior to loading, compilation 
prior to loading, just-in-time compilation, and re-compilation after loading and before 
execution of the relevant portion of application program. 

28. The system as claimed in claim 26 or 27 wherein said modified application 
program is transferred to all said computers in accordance with a procedure selected 
from the group consisting of master/slave transfer, branched transfer and cascaded 
transfer. . , 

29. A plurality of computers interconnected via a communications link and each 
having an independent local memory and substantially simultaneously operating a 
different portion at least one application program each written to operate on only a 
single computer, each local memory being accessible only by the corresponding portion 
of said application program. 

30. The plurality of computers as claimed in claim 29 wherein each said computer 
in operating said at least one application program reads and writes only to local 
memory physically located in each said computer, the contents of the local memory 
utilized by each said computer is fundamentally similar but not, at each instant, _ 
identical, and every one of said computers has distribution update means to distribute to 
all other said computers the content of any memory location updated by said one 
computer. , 

31. The plurality of computers as claimed in claim 29 or 30 wherein the local 
memory capacity allocated to the or each said application program is substantially 
identical and the total memory capacity available to the or each said application 
program is said allocated memory capacity. 

32. The plurality of computers as claimed in claim 30 or 3 1 wherein all said 
distribution update means communicate via said communications link at a data transfer 
rate which is substantially less than the local memory read rate. 

33. The plurality of computers as claimed in any one of claims 29-32 wherein at 
least some of said computers are manufactured by different manufacturers and/or have 
different operating systems. 
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34. A multiple computer system having at least one application program each 
written to operate on only a single computer but running substantially simultaneously 
on a plurality of computers interconnected by a communications network, wherein 
different portions of said application program(s) execute substantially simultaneously 

5 on different ones of said computers and for each said portion a like plurality of 

substantially identical objects are created, each in the corresponding computer and each 
having a substantially identical name, and wherein the initial contents of each of said 
identically named objects is substantially the same. 

35. The system as claimed in claim 34 wherein each said computer has a local 
10 memory accessible only by the corresponding portion of said application program. 

36. The system as claimed in claim 34 or 35 wherein each said computer includes 
a distributed run time means with the distributed run time means of each said computer 
able to communicate with all other computers whereby if a portion of said application 
program(s) running on one of said computers creates an object in that computer then the 

1 5 created object is propagated by the distributed run time means of said one computer to 
all the other computers. 

37. The system as claimed in any one of claims 34-36 wherein each said 
application program is modified before, during, or after loading by inserting an 
initialization routine to modify each instance at which said application program creates 

20 an object, said initialization routine propagating every object newly created by one 
computer to all said other computers. 

38. The system as claimed in claim 37 wherein said inserted initialization routine 
modifies a pre-existing initialization routine to enable the pre-existing initialization 
routine to execute on creation of the first of said like plurality of objects, and to disable 

25 the pre-existing initialization routine on creation of all subsequent ones of said like 
plurality of objects. 

39. The system as claimed in claim 37 or 38 wherein the application program is 
modified in accordance with a procedure selected from the group of procedures 
consisting of re-compilation at loading, pre-compilation prior to loading, compilation 

30 prior to loading, just-in-time compilation, and re-compilation after loading and before 
execution of the relevant portion of application program. 

40. The system as claimed in any one of claims 37-39 wherein said modified 
application program is transferred to all said computers in accordance with a procedure 
selected from the group consisting of master/slave transfer, branched transfer and 

35 cascaded transfer. 

41. A plurality of computers interconnected via a communications link and 
substantially simultaneously operating at least one application program each written to 
operation on only a single computer wherein each said computer substantially 
simultaneously executes a different portion of said application program(s), each said 

40 computer in operating its application program portion creates objects only in local 
memory physically located in each said computer, the contents of the local memory 
utilized by each said computer are fundamentally similar but not, at each instant, 
identical, and every one of said computers has distribution update means to distribute to 
all other said computers objects created by said one computer. 

45 42. The plurality of computers as claimed in claim 4 1 wherein the local memory 
capacity allocated to the or each said application program is substantially identical and 
the total memory capacity available to the or each said application program is said 
allocated memory capacity. 
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43. The plurality of computers as claimed in claim 41 or 42 wherein all said 
distribution update means communicate via said communications link at a data transfer 
rate which is substantially less than the local memory read rate. 

44. The plurality of computers as claimed in any one of claims 41-43 wherein at 
5 least some of said computers are manufactured by different manufacturers and/or have 

different operating systems. 

45 . A multiple computer system having at least one application program each 
written to operate only on a single computer but running substantially simultaneously 
on a plurality of computers interconnected by a communications network, wherein 

1 0 different portions of said application program(s) execute substantially simultaneously 
on different ones of said computers and for each said portion a like plurality of 
substantially identical objects are created, each in the corresponding computer and each 
having a substantially identical name, and wherein all said identical objects are 
collectively deleted when each one of said plurality of computers no longer needs to 

1 5 refer to their corresponding object. 

46. The system as claimed in claim 45 wherein each said computer includes a 
distributed run time means with the distributed run time means of each said computer 
able to communicate with all other computers whereby if a portion of said application 
program(s) running on one of said computers no longer needs to refer to an object in 

20 that computer then the identity of the unreferenced object is transmitted by the 

distributed run time means of said one computer to a shared table or record accessible 
by all the other computers. 

47. The system as claimed in claim 46 or 47 wherein each said application 
program is modified before, during, or after loading by inserting a finalization routine 

25 to modify each instance at which said application program no longer needs to refer to 
an object. 

48. The system as claimed in claim 47 wherein said inserted finalization routine 
modifies a pre-existing finalization routine to enable the pre-existing finalization 
routine to execute if all computers no longer need to refer to their corresponding object, 

30 and to disable the pre-existing finalization routine if at least one computer does need to 
refer to a corresponding object. 

49. The system as claimed in claim 47 or 48 wherein the application program is 
modified in accordance with a procedure selected from the group of procedures 
consisting of re-compilation at loading, pre-compilation prior to loading, compilation 

35 prior to loading, just-in-time compilation, and re-compilation after loading and before 
execution of the relevant portion of application program. 

50. The system as claimed in any one of claims 47-49 wherein said modified 
application program is transferred to all said computers in accordance with a procedure 
selected from the group consisting of master/slave transfer, branched transfer and 

40 cascaded transfer. 

51. A plurality of computers interconnected via a communications link and 
operating substantially simultaneously at least one application program each written to 
operate only on a single computer, wherein each said computer substantially 
simultaneously executes a different portion of said application program(s), each said 

45 computer in operating its application program portion needs, or no longer needs to refer 
to an object only in local memory physically located in each said computer, the 
contents of the local memory utilized by each said computer is fundamentally similar 
but not, at each instant, identical, and every one of said computers has a finalization 
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routine which deletes a non-referenced object only if each one of said plurality of 
computers no longer needs to refer to their corresponding object. 

52. The plurality of computers as claimed in claim 5 1 wherein the local memory 
capacity allocated to the or each said application program is substantially identical and 

5 the total memory capacity available to the or each said application program is said 
allocated memory capacity. 

53 . The plurality of computers as claimed in claim 5 1 or 52 wherein all said 
distribution update means communicate via said communications link at a data transfer 
rate which is substantially less than the local memory read rate. 

10 54. The plurality of computers as claimed in any one of claims 51-53 wherein at 
least some of said computers are manufactured by different manufacturers and/or have 
different operating systems. 

55. A multiple computer system having at least one application program each 
written to operate on only a single computer but running substantially simultaneously 

15 on a plurality of computers interconnected by a communications network, wherein 

different portions of said application program(s) execute substantially simultaneously 
on different ones of said computers and for each portion a like plurality of substantially 
identical objects are created, each in the corresponding computer and each having a 
substantially identical name, and said system including a lock means applicable to all 

20 said computers wherein any computer wishing to utilize a named object therein 

acquires an authorizing lock from said lock means which permits said utilization and 
which prevents all the other computers from utilizing their corresponding named object 
until said authorizing lock is relinquished. 

56. The system as claimed in claim 55 wherein said lock means includes an 

25 acquire lock routine and a release lock routine, and both said routines are included in 
modifications made to said application program running on all said computers. 

57. The system as claimed in claim 55 or 56 wherein said lock means further 
includes a shared table or record listing said named objects in use by any said computer, 
a lock status for each said object, and a queue of any pending lock acquisitions. 

30 58. The system as claimed in any one of claims 55-57 wherein said lock means is 
located within an additional computer not running said application program and 
connected to said communications network. 

59. The system as claimed in any one of claims 56-58 wherein each said 
application program is modified before, during, or after loading by inserting said 

35 acquire lock routine and said release lock routine to modify each instance at which said 
application program acquires and releases respectively a lock on an object. 

60. The system as claimed in claim 59 wherein the application program is 
modified in accordance with a procedure selected from the group of procedures 
consisting of re-compilation at loading, pre-compilation prior to loading, compilation 

40 prior to loading, just-in-time compilation, and re-compilation after loading and before 
execution of the relevant portion of application program. 

61 . The system as claimed in claim 59 or 60 wherein said modified application 
program is transferred to all said computers in accordance with a procedure selected 
from the group consisting of master/slave transfer, branched transfer and cascaded 

45 transfer. t , 

62. A plurality of computers interconnected via a communications link and 
operating substantially simultaneously at least one application program each written to 
operate on only a single computer, wherein each said computer substantially 
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simultaneously executes a different portion of said application program(s), each said 
computer in operating its application program portion utilizes an object only in local 
memory physically located in each said computer, the contents of the local memory 
utilized by each said computer is fundamentally similar but not, at each instant, 
5 identical, and every one of said computers has an acquire lock routine and a release 

lock routine which permit utilization of the local object only by one computer and each 
of the remainder of said plurality of computers is locked out of utilization of their 
corresponding object. 

63. The plurality of computers as claimed in claim 62 wherein the local memory 
1 0 capacity allocated to the or each said application program is substantially identical and 

the total memory capacity available to the or each said application program is 
substantially said allocated memory capacity. 

64. The plurality of computers as claimed in claim 62 or 63 wherein each said 
computer has a distribution update means communicate via said communications link at 

1 5 a data transfer rate which is substantially less than the local memory read rate. 

65 . The plurality of computers as claimed in any one of claims 62-64 wherein at 
least some of said computers are manufactured by different manufacturers and/or have 
different operating systems. 

66. A method of running simultaneously on a plurality of computers at least one 
20 application program each written to operate on only a single computer, said computers 

being interconnected by means of a communications network, said method comprising 
the step of, 

(i) executing different portions of said application program(s) on different ones 
of said computers and for each said portion creating a like plurality of substantially 
25 identical objects each in the corresponding computer and each accessible only by the 
corresponding portion of said application program. 

67. The method as claimed in claim 66 wherein each computer has an 
independent local memory which includes the corresponding identical object. 

68. The method as claimed in claim 66 or 67 comprising the further step of, 
30 (ii) naming each of said plurality of substantially identical objects with a 

substantially identical global name. 

69. The method as claimed in any one of claims 66-68 comprising the further step 
of, 

(iii) if a portion of said application program running on one of said computers 

35 changes the contents or value of an object in that computer, then the change in content 
or value of said object is propagated to all of the other computers via said 
communications network to change the content or value of the corresponding object in 
each of said other computers. 

70. The method as claimed in any one of claims 66-69 including the further step 
40 of:' 

(iv) modifying said application program before, during or after loading by 
inserting an updating propagation routine to modify each instance at which said 
application program writes to memory, said updating propagation routine propagating 
every memory write by one computer to all said other computers. 

45 71. The method as claimed in claim 70 including the further step of: 

(v) modifying said application program utilizing a procedure selected from the 
group of procedures consisting of re-compilation at loading, pre-compilation prior to 



-194- 



WO 2006/110957 



PCT/AU2006/000532 



loading, compilation prior to loading, just-in-time compilation, and re-compilation after 
loading and before execution of the relevant portion of application program. 

72. The method as claimed in claim 70 or 71 including the further step of: 

(vi) transferring the modified application program to all said computers utilizing a 
procedure selected from the group consisting of master/slave transfer, branched transfer 
and cascaded transfer. 

73. A method of loading an application program written to operate only on a 
single computer onto each of a plurality of computers, the computers being 
interconnected via a communications link, and different portions of said application 
program(s) being substantially simultaneously executable on different computers with 
each computer having an independent local memory accessible only by the 
corresponding portion of said application program(s), the method comprising the step 
of modifying the application before, during, or after loading and before execution of the 
relevant portion of the application program. 

74. The method as claimed in claim 73 wherein the modification of the 
application is different for different computers. 

75. The method as claimed in claim 73 or 74 wherein said modifying step 
comprises:- 

(i) detecting instructions which share memory records utilizing one of said 
computers, 

(ii) listing all such shared memory records and providing a naming tag tor each 
listed memory record, 

(iii) detecting those instructions which write to, or manipulate the contents oi, any 
of said listed memory records, and 

(iv) generating an updating propagation routine corresponding to each said 
detected write or manipulate instruction, said updating propagation routine forwarding 
the re-written or manipulated contents and name tag of each said re-written or 
manipulated listed memory record to all of the others of said computers. 

76. A method of operating simultaneously on a plurality of computers all 
interconnected via a communications link at least one application program each written 
to operate on only a single computer, each of said computers having at least a minimum 
predetermined local memory capacity, different portions of said application program(s) 
being substantially simultaneously executed on different ones of said computers with 
the local memory of each computer being only accessible by the corresponding portion 
of said application program(s), said method comprising the steps of: 

(i) initially providing each local memory in substantially identical condition, 

(ii) satisfying all memory reads and writes generated by each said application 
program portion from said corresponding local memory, and 

(iii) communicating via said communications link all said memory writes at each 
said computer which take place locally to all the remainder of said plurality of 
computers whereby the contents of the local memory utilised by each said computer, 
subject to an updating data transmission delay, remains substantially identical. 

77. The method as claimed in claim 76 including the further step of: 

(iv) communicating said local memory writes constituting an updating data 
transmission at a data transfer rate which is substantially less than the local memory 
read rate. . . 

78 A method of compiling or modifying an application program written to 
operate on only a single computer but to run simultaneously on a plurality of computers 
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interconnected via a communications link, with different portions of said application 
program(s) executing substantially simultaneously on different ones of said computers 
each of which has an independent local memory accessible only by the corresponding 
portion of said application program, said method comprising the steps of: 
5 (i) detecting instructions which share memory records utilizing one of said 
computers, 

(ii) listing all such shared memory records and providing a naming tag for each 
listed memory record, 

(iii) detecting those instructions which write to, or manipulate the contents of, any 
10 of said listed memory records, and 

(iv) activating an updating propagation routine following each said detected write 
or manipulate instruction, said updating propagation routine forwarding the re-written 
or manipulated contents and name tag of each said re-written or manipulated listed 
memory record to the remainder of said computers. 

1 5 79. The method as claimed in claim 78 and carried out prior to loading the 
application program onto each said computer, or during loading of the application 
program onto each said computer, or after loading of the application program onto each 
said computer and before execution of the relevant portion of the application program. 

80. In a multiple thread processing computer operation in which individual 

20 threads of a single application program written to operate on only a single computer are 
simultaneously being processed each on a different corresponding one of a plurality of 
computers each having an independent local memory accessible only by the 
corresponding thread and each being interconnected via a communications link, the 
improvement comprising communicating changes in the contents of local memory 

25 physically associated with the computer processing each thread to the local memory of 
each other said computer via said communications link. 

81. The improvement as claimed in claim 80 wherein changes to the memory 
associated with one said thread are communicated by the computer of said one thread to 
all other said computers. 

30 82. The improvement as claimed in claim 80 wherein changes to the memory 

associated with one said thread are transmitted to the computer associated with another 
said thread and are transmitted thereby to all said other computers. 

83. A method of running substantially simultaneously on a plurality of computers 
at least one application program each written to operate on only a single computer, said 

35 computers being interconnected by means of a communications network, said method 
comprising the steps of: 

(i) executing different portions of said application program(s) on different ones 
of said computers and for each said portion creating a like plurality of substantially 
identical objects each in the corresponding computer and each having a substantially 

40 identical name, and 

(ii) creating the initial contents of each of said identically named objects 
substantially the same. 

84. The method as claimed in claim 83 comprising the further step of, 

(iii) if a portion of said application program running on one of said computers 
45 creates an object in that computer, then the created object is propagated to all of the 

other computers via said communications network. 

85. The method as claimed in claim 83 or 84 including the further step of: 

(iv) modifying said application program before, during or after loading by 
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inserting an initialization routine to modify each instance at which said application 
program creates an object, said initialization routine propagating every object created 
by one computer to all said other computers. 

86. The method as claimed in claim 85 including the further step of: 

5 (v) modifying said application program utilizing a procedure selected from the 
group of procedures consisting of re-compilation at loading, pre-compilation prior to 
loading, compilation prior to loading, just-in-time compilation, and re-compilation after 
loading and before execution of the relevant portion of application program. 

87. The method as claimed in claim 85 or 86 including the further step of: 

1 0 (vi) transferring the modified application program to all said computers utilizing a 
procedure selected from the group consisting of master/slave transfer, branched transfer 
and cascaded transfer. 

88. A method of compiling or modifying an application program written to 
operate on only a single computer to have different portions thereof to execute 

1 5 substantially simultaneously on different ones of a plurality of computers 

interconnected via a communications link, said method comprising the steps of: 

(i) detecting instructions which create objects utilizing one of said computers, 

(ii) activating an initialization routine following each said detected object creation 
instruction, said initialization routine forwarding each created object to the remainder of 

20 said computers. 

89. The method as claimed in claim 88 and carried out prior to loading the 
application program onto each said computer, or during loading of the application 
program onto each said computer, or after loading of the application program onto each 
said computer and before execution of the relevant portion of the application program. 

25 90. In a multiple thread processing computer operation in which individual 

threads of a single application program written to operate on only a single computer are 
substantially simultaneously being processed each on a different corresponding one of a 
plurality of computers interconnected via a communications link, the improvement 
comprising communicating objects created in local memory physically associated with 

30 the computer processing each thread to the local memory of each other said computer 
via said communications link. 

91. The improvement as claimed in claim 90 wherein obj ects created in the 
memory associated with one said thread are communicated by the computer of said one 
thread to all other said computers. 

35 92. The improvement as claimed in claim 91 wherein objects created the memory 
associated with one said thread are transmitted to the computer associated with another 
said thread and are transmitted thereby to all said other computers. 

93. A method of ensuring consistent initialization of an application program 
written to operate on only a single computer but different portions of which are to be 

40 executed substantially simultaneously each on a different one of a plurality of _ 

computers interconnected via a communications network, said method comprising the 
steps of: 

(i) scrutinizing said application program at, or prior to, or after loading to detect 
each program step defining an initialization routine, and 
45 (ii) modifying said initialization routine to ensure consistent operation of all said 
computers. . ,. . . . 

94. The method as claimed in claim 93 wherein said initialization routine is 
modified to execute once only on the creation of a first object by any one of said 
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computers and is modified to be disabled on the creation of each subsequent peer copy 
of said object by the remainder of said computers. 

95 . The method claimed in claim 93 or 94 wherein step (ii) comprises the steps of: 

(iii) loading and executing said initialization routine on one of said computers, 
5 (iv) modifying said initialization routine by said one computer, and 

(v) transferring said modified initialization routine to each of the remaining 
computers. 

96. The method as claimed in claim 95 wherein said modified initialization 
routine is supplied by said one computer direct to each of said remaining computers. 

10 97. The method as claimed in claim 96 wherein said modified initialization 

routine is supplied in cascade fashion from said one computer sequentially to each of 
said remaining computers. 

98. The method claimed in claim 93 or 94 wherein step (ii) comprises the steps of: 

(vi) loading and modifying said initialization routine on one of said computers, 

1 5 (vii) said one computer sending said unmodified initialization routine to each of the 
remaining computers, and 

(viii) each of said remaining computers modifying said initialization routine after 
receipt of same. 

99. The method claimed in claim 98 wherein said unmodified initialization 

20 routine is supplied by said one computer directly to each of said remaining computers. 

1 00. The method claimed in claim 98 wherein said unmodified initialization 
routine is supplied in cascade fashion from said one computer sequentially to each of 
said remaining computers. 

101. A method of running substantially simultaneously on a plurality of computers 
25 at least one application program each written to operate only on a single computer, said 

computers being interconnected by means of a communications network, said method 
comprising the steps of: 

(i) executing different portions of said application program(s) on different ones 
of said computers and for each said portion creating a like plurality of substantially 

30 identical objects each in the corresponding computer and each having a substantially 
identical name, and 

(ii) deleting all said identical objects collectively when all of said plurality of 
computers no longer need to refer to their corresponding object. 

102. A method as claimed in claim 101 including the further step of: 
35 (iii) providing each said computer with a distributed run time means to 

communicate between said computers via said communications network. 

103. A method as claimed in claim 102 including the further step of: 

(iv) providing a shared table or record accessible by each said distributed run time 
means and in which is stored the identity of any computer which no longer requires to 

40 access an object, together with the identity of the object. 

104. A method as claimed in claim 103 including the further step of: 

(v) associating a counter means with said shared table, said counter means storing 
a count of the number of said computers which no longer require to access said object. 

105. A method as claimed in claim 104 including the further step of: 

45 (vi) providing an additional computer on which said shared program does not run 
and which hosts said shared table and counter, said additional computer being 
connected to said communications network. 
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106. A method of ensuring consistent finalization of an application program written 
to operate only on a single computer but different portions of which are to be executed 
substantially simultaneously each on a different one of a plurality of computers 
interconnected via a communications network, said method comprising the steps of: 

5 (i) scrutinizing said application program at, or prior to, or after loading to detect 
each program step defining an finalization routine, and 
(ii) modifying said finalization routine to ensure collective deletion of 
corresponding objects in all said computers only when each one of said computers no 
longer needs to refer to their corresponding object. 

10 107. The method as claimed in claim 106 wherein said finalization routine is 

modified to execute to clean-up an object once only and on only one of said computers 
and when all of said computers no longer need to refer to said object. 

108. The method claimed in claim 106 or 107 wherein step (ii) comprises the steps 
of: 

15 (iii) loading and executing said finalization routine on one of said computers, 

(iv) modifying said finalization routine by said one computer, and 

(v) transferring said modified finalization routine to each of the remaining 
computers. _ , 

109. The method as claimed in claim 108 wherein said modified finalization 

20 routine is supplied by said one computer direct to each of said remaining computers. 

110. The method as claimed in claim 1 08 wherein said modified finalization 
routine is supplied in cascade fashion from said one computer sequentially to each of 
said remaining computers. 

111. The method claimed in claim 106 or 1 07 wherein step (ii) comprises the steps 
25 of: 

(vi) loading and modifying said finalization routine on one of said computers, 

(vii) said one computer sending said unmodified finalization routine to each of the 
remaining computers, and 

(viii) each of said remaining computers modifying said finalization routine after 
30 receipt of same. 

1 12. The method claimed in claim 1 1 1 wherein said unmodified finalization 
routine is supplied by said one computer directly to each of said remaining computers. 

113. The method claimed in claim 1 1 1 wherein said unmodified finalization 
routine is supplied in cascade fashion from said one computer sequentially to each of . 

35 said remaining computers. 

1 14. The method as claimed in any one of claims 106-1 13 including the further 
step of: 

(ix) modifying said application program utilizing a procedure selected from the 
group of procedures consisting of re-compilation at loading, pre-compilation prior to 

40 loading, compilation prior to loading, just-in-time compilation, and re-compilation after 
loading and before execution of the relevant portion of application program. 

115. The method as claimed in claim 1 14 including the further step of: 

(x) transferring the modified application program to all said computers utilizing a 
procedure selected from the group consisting of master/slave transfer, branched transfer 

45 and cascaded transfer. 

116. In a multiple thread processing computer operation in which individual 
threads of a single application program written to operate only on a single computer are 
substantially simultaneously being processed each on a corresponding different one of a 
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plurality of computers interconnected via a communications link, and in which objects 
in local memory physically associated with the computer processing each thread have 
corresponding objects in the local memory of each other said computer the 
improvement comprising collectively deleting all said corresponding objects when each 
one of said plurality of computers no longer needs to refer to their corresponding 

° b l 17 ' The improvement as claimed in claim 1 16 wherein an object residing in the 
memory associated with one said thread and to be deleted has its identity 
communicated by the computer of said one thread to a shared table or record accessible 
by all other said computers. . 

1 1 8 The improvement as claimed in claim 1 1 6 wherein an object residing m the 
memory associated with one said thread and to be deleted has its identity transmitted to 
the computer associated with another said thread and is transmitted thereby to a shared 
table or record accessible by all said other computers. , (<nmni]tpI ., 

119 A method of running substantially simultaneously on a plurality ot computers 
at least one application program each written to operate only on a single computer said 
computers being interconnected by means of a communications network, said method 

ar PnSm e xecutfnTd^ferent portions of said application program(s) on different ones 
of said computers and for each said portion creating a like plurality of substantially 
identical objects each in the corresponding computer and each having a substantially 
identical name, and „* +u„«,;„ tr, 

fin requiring any of said computers wishing to utilize a named object therein to 
acquire an authorizing lock which permits said utilization and which pr ^nts al l the 
other computers from utilizing their corresponding named object until said authorizing 
lock is relinquished. f 

120 A method as claimed in claim 1 19 including the further step ot: 
(iii) providing each said computer with a distributed run time means to 
communicate between said computers via said communications network. 

121 . A method as claimed in claim 120 including the further step of: 
(M providing a shared table or record accessible by each said distributed run time 
means and in which is stored the identity of any computer which currently has to access 
an object, together with the identity of the object. 

122 A method as claimed in claim 121 including the further step ot: 

(v) ' associating a counter means with said shared table, said counter means storing 
a count of the number of said computers which seek access to said object. 

123 A method as claimed in claim 122 including the further step of: 

fvii ' providing an additional computer on which said shared program does not run 
and which hosts said shared table and counter, said additional computer being 
connected to said communications network. 

124 A method of ensuring consistent synchronization of an application program 
written to operate only on a single computer but different portions of which are to be 
executed substantially simultaneously each on a different one of a plurality ot _ 
computers interconnected via a communications network, said method comprising the 

(0 PS 0f scrutinizing said application program at, or prior to, or after loading to detect 

each program step defining an synchronization routine, and 

(H) modifying said synchronization routine to ensure utilization of an object by 
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only one computer and preventing all the remaining computers from simultaneously 
utilizing their corresponding objects. 

125. The method claimed in claim 124 wherein step (ii) comprises the steps of: 
(iii) loading and executing said synchronization routine on one of said computers, 

5 (iv) modifying said synchronization routine by said one computer, and 

(v) transferring said modified synchronization routine to each of the remaining 
computers. 

126. The method as claimed in claim 125 wherein said modified synchronization 
routine is supplied by said one computer direct to each of said remaining computers. 

10 127. The method as claimed in claim 125 wherein said modified synchronization 
routine is supplied in cascade fashion from said one computer sequentially to each of 
said remaining computers. 

128. The method claimed in any one of claims 124-127 wherein step (ii) comprises 
the steps of: 

1 5 (vi) loading and modifying said synchronization routine on one of said computers, 

(vii) said one computer sending said unmodified synchronization routine to each of 
the remaining computers, and 

(viii) each of said remaining computers modifying said synchronization routine 
after receipt of same. 

20 129. The method claimed in claim 128 wherein said unmodified synchronization 

routine is supplied by said one computer directly to each of said remaining computers. 
130. The method claimed in claim 128 wherein said unmodified synchronization 

routine is supplied in cascade fashion from said one computer sequentially to each of 

said remaining computers. 
25 131. The method as claimed in any one of claims 124-130 including the further 

step of: 

(ix) modifying said application program utilizing a procedure selected from the 
group of procedures consisting of re-compilation at loading, pre-compilation prior to 
loading, compilation prior to loading, just-in-time compilation, and re-compilation after 

30 loading and before execution of the relevant portion of application program. 
132. The method as claimed in claim 1 3 1 including the further step of: 

(x) transferring the modified application program to all said computers utilizing a 
procedure selected from the group consisting of master/slave transfer, branched transfer 
and cascaded transfer. 

35 133. In a multiple thread processing computer operation in which individual 

threads of a single application program written to operate only on a single computer are 
substantially simultaneously being processed each on a corresponding different one of a 
plurality of computers interconnected via a communications link, and in which objects 
in local memory physically associated with the computer processing each thread have 

40 corresponding objects in the local memory of each other said computer, the 

improvement comprising permitting only one of said computers to utilize an object and 
preventing all the remaining computers from simultaneously utilizing their 
corresponding object. 
1 34. The improvement as claimed in claim 1 33 wherein an object residing in the 

45 memory associated with one said thread and to be utilized has its identity 

communicated by the computer of said one thread to a shared table or record accessible 
by all other said computers. 
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135. The improvement as claimed in claim 133 wherein an object residing in the 
memory associated with one said thread and to be utilized has its identity transmitted to 
the computer associated with another said thread and is transmitted thereby to a shared 
table accessible by all said other computers. 
5 1 36. A computer program product comprising a set of program instructions stored 

in a storage medium and operable to permit at least one computer to carry out the 
method as claimed in any one of claims 66-135. 

137. A plurality of computers interconnected via a communication network and 
operable to ensure consistent operation of an application program written to operate 

1 0 only on a single computer but running substantially simultaneously of said computers, 
said computers being programmed to carry out the method as claimed in any one of 
claims 66-135 or being loaded with the computer program product as claimed in claim 
136. 

138. A distributed run time adapted to enable communications between a plurality 
1 5 of computers, computing machines, or information appliances. 

139. A modifier for modifying an application program written to execute on a 
single computer whereby the modified application program executes substantially 
simultaneously on a plurality of network computers or computing machines. 

20 
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